JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
System Administration Guide: Network Services     Oracle Solaris 10 8/11 Information Library
search filter icon
search icon

Document Information


Part I Network Services Topics

1.  Network Service (Overview)

2.  Managing Web Cache Servers

3.  Time-Related Services

Part II Accessing Network File Systems Topics

4.  Managing Network File Systems (Overview)

5.  Network File System Administration (Tasks)

6.  Accessing Network File Systems (Reference)

Part III SLP Topics

7.  SLP (Overview)

8.  Planning and Enabling SLP (Tasks)

9.  Administering SLP (Tasks)

10.  Incorporating Legacy Services

11.  SLP (Reference)

Part IV Mail Services Topics

12.  Mail Services (Overview)

13.  Mail Services (Tasks)

14.  Mail Services (Reference)

Part V Serial Networking Topics

15.  Solaris PPP 4.0 (Overview)

16.  Planning for the PPP Link (Tasks)

17.  Setting Up a Dial-up PPP Link (Tasks)

18.  Setting Up a Leased-Line PPP Link (Tasks)

19.  Setting Up PPP Authentication (Tasks)

20.  Setting Up a PPPoE Tunnel (Tasks)

21.  Fixing Common PPP Problems (Tasks)

22.  Solaris PPP 4.0 (Reference)

Using PPP Options in Files and on the Command Line

Where to Define PPP Options

How PPP Options Are Processed

How PPP Configuration File Privileges Work

User Privileges

File Privileges

Effects of Option Privileges

/etc/ppp/options Configuration File

/etc/ppp/options.tmpl Template

Where to Find Examples of the /etc/ppp/options Files

/etc/ppp/options.ttyname Configuration File

Using /etc/ppp/options.ttyname on a Dial-in Server

Using /etc/ppp/options.ttyname on a Dial-out Machine

options.ttya.tmpl Template File

Where to Find Examples of the /etc/ppp/options.ttyname Files

Configuring User-Specific Options

Configuring $HOME/.ppprc on a Dial-in Server

Configuring $HOME/.ppprc on a Dial-out Machine

Specifying Information for Communicating With the Dial-in Server

/etc/ppp/peers/peer-name File

/etc/ppp/peers/myisp.tmpl Template File

Where to Find Examples of the /etc/ppp/peers/peer-name Files

Configuring Modem Speed for a Dial-up Link

Defining the Conversation on the Dial-up Link

Contents of the Chat Script

Chat Script Examples

Basic Modem Chat Script

/etc/ppp/myisp-chat.tmpl Chat Script Template

Modem Chat Script for Calling an ISP

Basic Chat Script Enhanced for a UNIX-Style Login

Chat Script for External ISDN TA

For More Chat Script Examples

Invoking the Chat Script

How to Invoke a Chat Script (Task)

Creating a Chat File That Is Executable

How to Create an Executable Chat Program

Authenticating Callers on a Link

Password Authentication Protocol (PAP)

/etc/ppp/pap-secrets File

Creating PAP Passwords

What Happens During PAP Authentication

Using the login Option With /etc/ppp/pap-secrets

Challenge-Handshake Authentication Protocol (CHAP)

/etc/ppp/chap-secrets File

What Happens During CHAP Authentication

Creating an IP Addressing Scheme for Callers

Assigning Dynamic IP Addresses to Callers

Assigning Static IP Addresses to Callers

Assigning IP Addresses by sppp Unit Number

Creating PPPoE Tunnels for DSL Support

Files for Configuring Interfaces for PPPoE

/etc/ppp/pppoe.if File

/usr/sbin/sppptun Command

Examples of sppptun Commands for Administering Interfaces

PPPoE Access Server Commands and Files

/usr/lib/inet/pppoed Daemon

/etc/ppp/pppoe File

/etc/ppp/pppoe.device File Plugin

Using PPPoE and PPP Files to Configure an Access Server

PPPoE Client Commands and Files

/usr/lib/inet/pppoec Utility Shared Object

/etc/ppp/peers/peer-name File for Defining an Access Server Peer

23.  Migrating From Asynchronous Solaris PPP to Solaris PPP 4.0 (Tasks)

24.  UUCP (Overview)

25.  Administering UUCP (Tasks)

26.  UUCP (Reference)

Part VI Working With Remote Systems Topics

27.  Working With Remote Systems (Overview)

28.  Administering the FTP Server (Tasks)

29.  Accessing Remote Systems (Tasks)

Part VII Monitoring Network Services Topics

30.  Monitoring Network Performance (Tasks)



Specifying Information for Communicating With the Dial-in Server

To communicate with a dial-in server, you need to gather information about the server. Then edit a few files. Most significantly, you must configure the communications requirements of all dial-in servers that the dial-out machine needs to call. You can specify options about a dial-in server, such as an ISP phone number, in the /etc/ppp/options.ttyname file. However, the optimum place to configure peer information is in /etc/ppp/peers/peer-name files.

/etc/ppp/peers/peer-name File

Note - The /etc/ppp/peers/peer-name file is not needed on the dial-out machine for Solaris PPP 4.0 to work correctly.

Use the /etc/ppp/peers/peer-name file to provide information for communicating with a particular peer. /etc/ppp/peers/peer-name allows ordinary users to invoke preselected privileged options that users are not allowed to set.

For example, a nonprivileged user cannot override the noauth option if noauth is specified in the /etc/ppp/peers/peer-name file. Suppose the user wants to set up a link to peerB, which does not provide authentication credentials. As superuser, you can create a /etc/ppp/peers/peerB file that includes the noauth option. noauth indicates that the local machine does not authenticate calls from peerB.

The pppd daemon reads /etc/ppp/peers/peer-name when pppd encounters the following option:

call  peer-name

You can create a /etc/ppp/peers/peer-name file for each target peer with which the dial-out machine needs to communicate. This practice is particularly convenient for permitting ordinary users to invoke special dial-out links without needing root privileges.

Typical options that you specify in /etc/ppp/peers/peer-name include the following:

See the pppd(1M) man page for more options that might apply to a specific target peer.

/etc/ppp/peers/myisp.tmpl Template File

The /etc/ppp/peers/myisp.tmpl file contains helpful comments about the /etc/ppp/peers/peer-name file. The template concludes with common options that you might use for an /etc/ppp/peers/peer-name file:

connect "/usr/bin/chat -f /etc/ppp/myisp-chat" 
user myname             
remotename myisp        
connect "/usr/bin/chat -f /etc/ppp/myisp-chat"
Call the peer by using the chat script /etc/ppp/myisp-chat.
user myname
Use this account name for the local machine. myname is the name for this machine in the peer's /etc/ppp/pap-secrets file.
remotename myisp
Recognize myisp as the name of the peer in the local machine's /etc/ppp/pap-secrets file.
Do not require calling peers to provide authentication credentials.
Do not use a default IP address for the local machine.
Use the default route that is assigned to the local machine.
Log errors in the PPP log files, rather than on the standard output.
Do not use CCP compression.

To use /etc/ppp/peers/myisp.tmpl at your site, rename /etc/ppp/peers/myisp.tmpl to /etc/ppp/peers/.peer-name. Replace peer-name with the name of the peer to be called. Then modify the file contents as needed by your site.

Where to Find Examples of the /etc/ppp/peers/peer-name Files

To find examples of the /etc/ppp/peers/peer-name files, refer to the following: