1. Manuals
  2. Tumbleweed
  3. wicked
  4. ifcfg-ppp(5)

Scroll to navigation

IFCFG-PPP(5) Network configuration 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:

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

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

PROVIDER FILE CONFIGURATION OPTIONS

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 at <http://bugs.opensuse.org>

AUTHOR

Pawel Wieczorkiewicz -- original ppp man page

SEE ALSO

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

May 2016 wicked