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)