Editing the Link Configuration File (link.conf)
The link configuration file (/etc/opt/SUNWconn/ppp/link.conf) describes the synchronous and asynchronous devices used to establish the PPP link, and includes dialing information for asynchronous links.
The first section in the link configuration file is used to define the location of the modem configuration file and the directory that contains the connect (or CHAT) scripts. By default, the modem configuration file is /etc/opt/SUNWconn/ppp/modems and the connect (or CHAT) scripts are contained in the directory /etc/opt/SUNWconn/ppp/script.
Defining Synchronous Devices
Synchronous devices are identified in the file link.conf by the keyword sync_device, which starts each definition.
Synopsis
Synchronous device definitions have the following general form:
sync_device syncdevn
unix_device device_name
line_speed line_speed
tx_clock txc
rx_clock rxc
|
Keywords
Mandatory parameter for synchronous devices. Indicates the start of a synchronous device definition, and assigns a name to the device.
Mandatory parameter for synchronous devices. Identifies the serial port used for synchronous communication, and associates the synchronous device with one of the synchronous paths defined in the file ppp.conf. The value device_name must be the device name of a synchronous serial interface installed in your machine.
For example, device names of the form zshn associate the path with one of the on-board serial interfaces. The device names of the form hihn, associate the path with a high-speed serial interface (HSI).
Mandatory parameter for synchronous devices when internal clocking is selected. The optimum line speed is dependent on the serial device selected. The default value proposed is the optimum line speed for one of the onboard serial interfaces (zsh). Refer to the manufacturer's documentation, if you are using a different serial device.
Mandatory parameter for synchronous devices. Specifies the source of the transmit clock signal. The value txc can be baud (internal clocking using system baud rate), txc (external clocking using the signal on the transmit pin), or rxc (external clocking using the signal on the receive pin). The transmit clock is most commonly set to baud (internal clocking), or txc (external clocking).
Mandatory parameter for synchronous devices. Specifies the source of the receive clock signal. The value rxc can be baud (internal clocking using system baud rate), txc (external clocking using the signal on the transmit pin), or rxc (external clocking using the signal on the receive pin). The receive clock is most commonly set to rxc, for both internal and external clocking.
Examples
The following synchronous device definition uses a high-speed serial interface (hih) and external clocking:
sync_device syncdev0
qqunix_devicee hih0
line_speed 0
tx_clock txc
rx_clock rxc
|
The following synchronous device definition uses one of the onboard serial interfaces (zsh) and internal clocking:
sync_device syncdev0
unix_device zsh0
line_speed 19200
tx_clock baud
rx_clock rxc
|
Defining Asynchronous Devices
Asynchronous devices are identified in the file link.conf by the keyword dialup_device, which starts each definition.
Synopsis
Asynchronous device definitions have the following general form:
dialup_device pppdevn
unix_device device_name
line_speed speed
modem modem_id
calls call_type
|
Keywords
Mandatory parameter for asynchronous devices. Indicates the start of an asynchronous device definition, and assigns a name to the device.
Mandatory parameter for asynchronous devices. Specifies the serial port used to connect between the host and the modem.
Mandatory parameter for asynchronous devices. Specifies the line speed for the connection between the host and the modem. For optimum performance, the line speed should be equal to, or greater than, the baud rate of the modem. The option ctsrts enables software flow control using Clear to Send and Ready to Send signals.
Mandatory parameter for asynchronous devices. Specifies the type of modem connected to the serial port, and associates the asynchronous device with one of the definitions in the modem database, which is the file /etc/opt/SUNWconn/ppp/modems by default. This parameter is set to none for a null modem configuration.
Mandatory parameter for asynchronous devices. Specifies the behavior of the device during the call setup phase. The value call_type can be answer (device accepts calls only), dial (device makes initiates calls only), or both (device accepts and initiates calls).
Examples
The following asynchronous device definitions use a BocaModem V.34 DataFax modems, and a line speed of 38400. The first device accepts and initiates calls; the second device initiates calls only:
dialup_device pppdev0
unix_device ttya
line_speed 38400
modem BocaModem V.34 DataFax
call_setup both
dialup_device pppdev1
unix_device ttyb
line_speed 38400
modem BocaModem V.34 DataFax
call_setup dial
|
The following asynchronous device definition accepts calls in a null modem configuration:
dialup_device pppdev0
unix_device ttya
line_speed 38400
modem none
call_setup answer
|
Defining a Pool of Asynchronous Devices
If you create more than one asynchronous device definition in the file link.conf, you can define a pool of asynchronous devices.
A pool of devices is associated with one or more remote hosts, in exactly the same way as an individual device. When an incoming or outgoing connection request for one of these hosts is processed, an asynchronous device is selected from the pool automatically, for as long as there are devices available in the pool.
Synopsis
A device pool definition has the following general form:
pool_device pooln pppdevn pppdevn+1 ... |
Keywords
pool_device pooln
Mandatory parameter to enable device pooling. Indicates the start of a device pool definition, and assigns a name to the device.
pppdevn pppdevn+1 ...
Mandatory parameters to enable device pooling. Specifies a list of asynchronous devices included in the device pool. Device names must be separated by spaces or commas.
Examples
The following example shows a device pool that consists of four asynchronous devices:
pool_device pool0 pppdev0 pppdev1 pppdev2 pppdev3 |
Defining Remote Hosts
The link configuration file (link.conf) also contains a list of the remote hosts to which the local host can initiate asynchronous connections. All remote host definitions must be entered after the synchronous and asynchronous device definitions.
Synopsis
A remote host definition has the following general form:
remote_host name
phone_number number
chat_script filename
use_device pppdevn
|
Keywords
Mandatory parameter for remote host definitions. Indicates the start of a remote host definition, and associates it with one of the asynchronous paths defined in the PPP path configuration file (ppp.conf).
Mandatory parameter for remote host definitions. Specifies the telephone number used to call the remote host. This can be an extension number if the call is within the same private branch exchange. Assign a "dummy" telephone number for null modem configurations. Telephone numbers can include both digits and characters, including special characters such as # and *. A comma (,) is used to insert a pause. The duration of the pause is usually 2 seconds, but is programmable on most modems. Telephone numbers that are prefixed by the letter P indicate that pulse dialing mode should be used.
Mandatory parameter for remote host definitions. Specifies the name of the file that contains the CHAT script, which defines the dialog used to set up the connection.
Optional parameter for remote hosts. Specifies a device, or pool of devices, to be used for this remote host.
- © 2010, Oracle Corporation and/or its affiliates