IFCFG-PPP(5)

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 specifying 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 specifying 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 only set 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 data traffic 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-up script 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 server provided 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 modification of the user addresses with the addresses negotiated with the peer. In order to set the user addresses prior negotiation 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 bundle between 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 more information 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 immediately 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 variable is set to true. Default: 15
MAXFAIL [num]
    Specifies the number of reconnection attempts to be made by pppd instance when unable to establish the 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: /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. /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 into pppd(8). or pppoe(8)

COPYRIGHT
Copyright (C) 2016 SUSE Linux GmbH, Nuernberg, Germany.

BUGS
Please report bugs as described at <https://bugs.opensuse.org>

AUTHOR
Pawel Wieczorkiewicz -- original ppp man page

SEE ALSO
pppd(8), ifcfg(5), wicked(8), pppoe(8), netconfig(8)