MAN page from openSUSE Tumbleweed wicked-0.6.45-1.1.i586.rpm

IFCFG-PPP

Section: Network configuration (5)
Updated: May 2016
Index

NAME

ifcfg-ppp - interface ppp configuration

SYNOPSIS

/etc/sysconfig/network/ifcfg-*

/etc/sysconfig/network/providers/provider*

PPP Interfaces

To setup a PPP interface you need a configuration file ifcfg-ppp<X> (hint: an arbitrary name might be used for ppp device e.g. dsl0 for DSL connection) with the usual network settings. But you must add additional variables:

PPPMODE {pppoe|pppoatm|pptp|isdn|serial|modem}

must be set to one of the following types to identify this interface as a ppp interface:

pppoe ---Point-to-Point over Ethernet (PPPoE) device type.

pppoatm ---Point-to-Point over Asynchronous Transfer Mode (PPPoATM) device type. Currently NOT SUPPORTED.

pptp ---Point-to-Point Tunneling Protocol (PPTP) device type. Currently NOT SUPPORTED.

isdn ---Point-to-Point for ISDN connection types. NOT SUPPORTED.

serial ---Point-to-Point for general serial connections via fixed line or modem. NOT SUPPORTED.

modem ---Point-to-Point for connections using 3G/UMTS modems. NOT SUPPORTED.

PROVIDER [filename]

: Variable specifing the filename of a provider configuration file in the /etc/sysconfig/network/providers/directory. The provider file contains provider specific configuration options.

PPPDEBUG {true|false}

: Enables pppd instance debug mode.

PPPoE MODE SPECIFIC OPTIONS

DEVICE [ifname]

: Variable specifing the real, subordinate ethernet device interface name to be used to establish PPP connection.

PROVIDER FILE CONFIGURATION OPTIONS

DEFAULTROUTE {true|false}

: Set a default route in the system routing tables, using the peer as the gateway. The default route is onlyset when IPCP negotiation succeeded and automatically removed when PPP connection stops.The current default route in the routing tables will be replaced with the new default route.
Default: true

DEMAND {true|false}

: Initiate the link only when data traffic is present. This option allows the remote IP address to be specified.The interface is initially pre-configured and enabled for IP traffic, but without connection to the peer.Upon traffic the connection to the peer happens along with negotiation, authentication, etc.
Default: false

IDLETIME [seconds]

: Specifies the time in seconds after which the idle link is disconnected. The link is idle when no datatraffic is being sent or received. For more info please refer to pppd(8).
Default: 600

AUTODNS {true|false}

: Obtain the DNS server addresses from the peer. The addresses (if any) are passed to the /etc/ppp/ip-upscript in the environment variables DNS1 and DNS2, and the environment variable USEPEERDNS will be set to 1.The option requires the MODIFYDNS variable to be set to true in order to take any effect.
Default: true

DNS1/DNS2 [IP-address]

: Specify the DNS server addresses to set in the system with lowered preference than the serverprovided by the peer, e.g. initiate the connection on dns queries in demand dialing mode,or as fallback when the peer does not provide any dns servers.The servers are applied by wicked using the /etc/ppp/{pre-start,post-stop} scripts.

MODIFYIP/MODIFYIP6 {true|false}

: When user specified local and/or remote IP addresses for the link, this options allows for modificationof the user addresses with the addresses negotiated with the peer. In order to set the user addresses priornegotiation with the peer, the DEMAND variable must be set to true.Without this option, the pppd instance will not accept different values in the IPCP negotiation.
Default: true

IPADDR [IP-address]

: IPv4 address to be set as a local IP of the PPP connection.

REMOTE_IPADDR [IP-address]

: IPv4 address to be set as a remote IP of the PPP connection.

IPADDR6 [localinterfaceidentifier]

: IPv6 local identifier to be set as a local IP of the PPP connection.

REMOTE_IPADDR6 [remoteinterfaceidentifier]

: IPv6 remote identifier to be set as a remote IP of the PPP connection.

MULTILINK {true|false}

: Enables the PPP multilink protocol. If supported by the peer, the link created can become part of a bundlebetween the local system and the peer.
Default: false

ENDPOINT [discriminator]

: Sets the endpoint discriminator sent by local host to the peer during multilink negotiation. For moreinformation please refer to the pppd(8).Must be specified when MULTILINK variable is set to true.

AUTO_RECONNECT {true|false}

: Instructs the pppd instance to automatically try to reopen the terminated connection when set to true.Otherwise the pppd instance exits immidiately after a connection has been made and terminated.The number of attempts can be specified using MAXFAIL variable.The delay between the attempts can be specified using AUTO_RECONNECT_DELAY variable.
Default: false

AUTO_RECONNECT_DELAY [seconds]

: Specifies the number of seconds of the delay between reconnection attempts when AUTO_RECONNECT variableis set to true.
Default: 15

MAXFAIL [num]

: Specifies the number of reconnection attempts to be made by pppd instance when unable to establishthe connection.
Default: 10

USERNAME [string]

: Specifies the user name used for authenticating the local system to the peer.

PASSWORD [string]

: Specifies the user password used for authenticating the local system to the peer.

Example

Example of a simple DSL related PPPoE interface configuration and its corresponding provider file:

.I/etc/sysconfig/network/ifcfg-dsl0

    STARTMODE='auto'    BOOTPROTO='static'    DEVICE='eth0'    PPPMODE='pppoe'    PROVIDER='provider0'

/etc/sysconfig/network/provider/provider0
    PROVIDER='Provider name'
    AUTODNS='false'
    AUTO_RECONNECT='true'
    DEFAULTROUTE='true'
    DEMAND='false'
    IDLETIME=''
    MODIFYIP='false'
    IPADDR=''
    REMOTE_IPADDR=''
    MODIFYDNS='false'
    USERNAME='user'
    PASSWORD='XXXXXXXXXX'

Example of an advanced DSL related PPPoE interface configuration and its corresponding provider file.

.I/etc/sysconfig/network/ifcfg-dsl1

    STARTMODE='auto'    BOOTPROTO='static'    DEVICE='eth1'    PPPMODE='pppoe'    PROVIDER='provider1'

/etc/sysconfig/network/provider/provider1
    PROVIDER='Provider name'
    AUTODNS='false'
    AUTO_RECONNECT='true'
    DEFAULTROUTE='true'
    DEMAND='true'
    IDLETIME=''
    MODIFYIP='true'
    IPADDR='10.0.0.1'
    REMOTE_IPADDR='10.0.0.2'
    MODIFYDNS='false'
    USERNAME='user'
    PASSWORD='XXXXXXXXXX'

Additional Information

For additional and more general information take a look intopppd(8).orpppoe(8)

COPYRIGHT

BUGS

Please report bugs at <http://bugs.opensuse.org>

AUTHOR

Pawel Wieczorkiewicz -- original ppp man page

This document was created byman2html,using the manual pages.