CINTERNET(1)                                                          SMPPPD                                                          CINTERNET(1)

NAME

       cinternet - simple frontend for smpppd

DESCRIPTION

       cinternet is a simple frontend for the smpppd.

OPTIONS

       These  options are recognized by cinternet.  If a long option shows an argument as mandatory, then it is mandatory for the equivalent short
       option also.

       The order of the options is relevant except for the --verbose, --only-local, --version and --help options.

       -I, --interface-list
              List all configured interfaces of the smpppd.  The interfaces are also marked either with `u' or `d' for their status of up or  down
              respectively.  The interface names are utf-8 encoded.

       -i, --interface-name=NAME
              Specify a interface.  A interface must be specified for most of the options below.  This option must be given before any option that
              requires an interface.  The name must exactly match one of the interface list.

       --interface-number=NUM
              Specify a interface.  A interface must be specified for most of the options below.  This option must be given before any option that
              requires an interface.  The numbers start at one.

       -P, --provider-list
              List all configured providers for the specified interface.  The currently active provider is prefixed by a `a', all others by a `i'.
              The provider names are utf-8 encoded.

       -p, --provider-name=NAME
              Select the active provider for the specified interface by name.  The name must exactly match one of the provider list.   Only  works
              when the interface is down.

       --provider-number=NUM
              Select the active provider for the specified interface by number.  The numbers start at one.  Only works when the interface is down.

       -A, --start
              Start the specified interface.

       -D, --dialin
              Trigger  dialin for the specified interface.  The interface must be in dial on demand mode and already started.  Not implemented for
              all connection types.

       -H, --hangup
              Trigger hangup for the specified interface.  The interface must be in dial on demand  mode.   Not  implemented  for  all  connection
              types.

       -O, --stop
              Stop the specified interface.

       --add-link
              Add a link to a multi-link connection.

       --remove-link
              Remove a link from a multi-link connection.

       -s, --status
              Display the status of the specified interface.

       -c, --config
              Display the configuration of the specified interface.

       -l, --log
              Displays the log of the specified interface.

       -d, --debug={on,off}
              Turn debugging mode of the smpppd on or off.  This does not affect connections already up.

       -L, --main-config
              List the main config of the smpppd.

       -L, --main-log
              List the main log, the log containing general informations not specific to an interface, of the smpppd.

       -v, --verbose
              Be more verbose.

       -o, --only-local
              Only connect to local smpppd.

       --script[=STYLE]
              Format output for script.  Known styles are c and sh.

       --version
              Show program version and exit.

       --help Show help information and exit.

WIRELESS LAN OPTIONS

       The following commands are only valid if the specified interface is a wireless LAN device.

       --set-essid=ESSID
              Set ESSID (network name).

       --set-bitrate=BITRATE
              Set a specific bitrate (in Mbps units). Use auto or 0 to switch to automatic mode.

       --set-wep=KEY
              Enables WEP encryption for the specified interface.  KEY can have different formats, see --keytype for more information.

       --scan Prints scan results, i.e. access points known to the driver. Note that this does not trigger an active scan.

       --rescan
              Triggers an active scan and prints the scan results. Note that this can interrupt exiting connections for a while.

       --keytype={hex,ascii,hash[40,104]}
              Sets  key  type  for  --set-wep  command.  hex means the key is given has hex digits. You need to enter exactly the amount of digits
              needed for the key (e.g. 10 hex digits for 40 bit key, 26 hex digits for 104 bit key, etc).  ascii means that the  ASCII  values  of
              the specified string from the key. You need to enter 5 characters for 40 bit keys, 13 for 104 bit keys, etc.  And finally hash means
              the specified key is used as a passphrase to generate a hash from it, which will be the actual WEP key. Append 40  to  hash  if  you
              want a 40 bit key generated, and 104 if you want 104 bit (aka 64 and 128 bit, depends on whether you count the initialization vector
              or not). If the appendix is omitted, 104 bit gets assumed.

       --authmode={open,shared}
              This option has to be used together with the --set-wep command. It specifies the authentication mode to  be  used.   open  means  no
              explicit  authentication  (this does not neccessarily mean no encryption).  shared means shared key authentication. This authentica-
              tion mode makes your WEP key more attackable, so do not use it if you don't have to.

       --connection-status
              Prints some information about your wireless LAN connection status.

FILES

       /etc/smpppd-c.conf
              Contains information about remote smpppd.

       /var/run/smpppd/control
              Socket to communicate with local smpppd.

SEE ALSO

       kinternet, qinternet, accounting(1), smpppd-c.conf(5), smpppd(8), smpppd-ifcfg(8).

AUTHOR

       Arvin Schnell <arvin@suse.de>

SuSE                                                               December 2002                                                      CINTERNET(1)