@database StartInet.guide
@master Inet:docs/I-Net.guide
@index "Inet:docs/Index.guide/main"
@REM $VER: StartInet.guide 1.6 (6.12.95)
@author "Jim Cooper"
@Width 80
@SmartWrap

@node "Main" "StartInet"
@{b}StartInet@{ub}								@{b}StartInet@{ub}

NAME

    @{b}StartInet@{ub} - Network startup utility.

SYNOPSIS

    @{b}StartInet@{ub} BROADCAST/K,DELAYSTART/K/N,DESTIP/K,INET/K,NETMASK/K,PPP/S,
              SERVERS/S,VERBOSE/S

DESCRIPTION

    The @{b}StartInet@{ub} utility is used to initialize the network software on
    your system.

    The parameters shown may also be used as ToolTypes if started from
    Workbench.	The sample icon supplied has all ToolTypes included
    (though commented out).

EXAMPLES

	StartInet DESTIP=200.0.0.1

    This command is the minimal needed to start a network connection if
    you only wish to go from your machine out.

	StartInet DESTIP=200.0.0.1 SERVERS

    This command will allow 2-way communications, since the standard
    servers will be started for the other side to be able to contact your
    machine.

SEE ALSO

    @{" BROADCAST " link "BROADCAST"}, @{" DELAYSTART " link "DELAYSTART"}, @{" DESTIP " link "DESTIP"}, @{" INET " link "INET"}, @{" NETMASK " link "NETMASK"}, @{" PPP " link "PPP"},
    @{" SERVERS " link "SERVERS"}, @{" VERBOSE " link "VERBOSE"}
@endnode

@node "BROADCAST"
    Use this parameter to set a BROADCAST mask for your network.  Normally
    not needed, but if you have problems, try using this parameter to set
    the BROADCAST mask your InterNet Service Provider specified.
@endnode

@node "DELAYSTART"
    This parameter supplies a numeric value which specifies number of
    seconds to delay before actually starting the network software.  This
    can be useful if you need to make certain some other software is
    started before the network is initialized. For instance, if you also
    use @{b}ENLAN-DFS@{ub} (another @{i}Interworks@{ui} product), you would use this
    parameter to make sure @{b}ENLAN-DFS@{ub} has enough time to start first (as it
    must!).
@endnode

@node "DESTIP"
    Use this parameter to specify the network address (in standard IP
    address numeric form) of the default machine yours should talk with.
    For standard EtherNet setups, this will be the GATEWAY address.  For
    SLIP or other Point-to-Point type setups, this is the destination
    machine's IP address.

    @{b}NOTE:@{ub}  This parameter @{i}@{u}must@{ui}@{uu} be specified, or StartInet will refuse
    to start the network software.
@endnode

@node "INET"
    If you wish, you may specify the path to the network
    software via this parameter, and the INET: assignment will
    be created by StartInet (if it doesn't already exist).  If
    you do not use this parameter to set the path, it must
    already exist in your system before StartInet runs, or the
    network software cannot be initialized.

    This parameter could be useful in an unattended server setup.  Just
    drop the @{b}StartInet@{ub} icon in the WBStartup drawer with this set as a
    ToolType, and no modifications will be necessary to the
    Startup-Sequence of that machine.
@endnode

@node "NETMASK"
    Use this parameter to set a NETMASK for your network.  Normally not
    needed, but if you have problems, try using this parameter to set the
    NETMASK your InterNet Service Provider specified.
@endnode

@node "PPP"
    This switch will cause StartInet to use slightly different actions
    in order to set the network up to properly use Holger Kruse's PPP
    driver (ppp.device) correctly.  If you set ppp.device as your main
    network device, and do NOT use this switch, the network software
    will not be properly initialized, and will not work correctly.
@endnode

@node "SERVERS"
    This switch will cause the standard system daemons to be started at
    network initialization time.  These daemons include FTPd, TELNETd,
    etc.
@endnode

@node "VERBOSE"
    This switch causes StartInet to print all major operations it performs.
    Each line executed is printed with a leading string of "--> ".  A lot
    of extra info for normal operation, but useful when trying to track
    down a problem in your setup.
@endnode