slattach(1M)                                            slattach(1M)


       NAME
             slattach - attach serial lines as network interfaces

       SYNOPSIS
             slattach [{+|-}{c|e|f|i|m mtu|v} ...] tty_name source_address
                   destination_address [baud_rate]

             slattach [{+|-}{c|e|f|i|m mtu|v} ...] -d uucp_name source_address
                     destination_address [baud_rate]

       DESCRIPTION
             The slattach command is used for assigning the tty line
             tty_name to a network interface, as well as for defining the
             network source_address and destination_address values.

          Exit Codes
             The exit status will reflect the following conditions:
                   0 link broken after successful connection
                   1 fatal error before successful connection
                   2 UUCP dial failure
                   3 fork or wait system call error
                   4 child process killed by signal

          Diagnostics
             The following error messages may occur:
                   mtu too small, using default
                   invalid baud rate
                   dial failure using uucp system
                   the specified interface does not exist
                   the requested address is unknown
                   a non-privileged user tried to alter the configuration
                   for an interface

       USAGE
             Only a privileged user may attach (or detach) a network
             interface.

             In the first form, the tty_name parameter is the name of the
             serial line over which Serial Line IP (SLIP) will run.  If the
             tty_name parameter does not begin with /dev/, then /dev/ will
             be prepended to tty_name.

             In the second form, the uucp_name parameter is a reference to
             a remote UUCP host as found in the uucp Systems file.  The
             appropriate device and chat script as defined in the BNU
             configuration files will be used to dial and log into the


                           Copyright 1994 Novell, Inc.               Page 1

      slattach(1M)                                            slattach(1M)


            remote host.  Note that the dialing and network configuration
            is done by a child process in this case.

            The optional baud_rate parameter is used to set the speed of
            the connection. If not specified, the default value of 9600
            will be used.

            To detach a SLIP interface, you should kill the slattach
            process and then use the following command to remove this
            Point-to-Point route from the Routing Table:
                  route delete destination_address gateway_address

         Options
            The following optional arguments can be used to ``fine tune''
            how the network interface is to behave:

            {+|-}c      Turn the TCP/IP header compression mode on (+) or
                        off (-).  The default setting is off.

            {+|-}e      Turn the automatic detection and the use of TCP/IP
                        header compression on or off.  The default setting
                        is off.

                        If the flag +c is given, then this flag (either +e
                        or -e) has no effect.  When the flag +e is given,
                        the SLIP module will not send any compressed
                        TCP/IP headers until it has received and
                        successfully uncompressed a compressed TCP/IP
                        packet.

                        Note that, if both ends of the connection use the
                        flag +e and if neither end uses +c, then the
                        TCP/IP header compression mode will never get
                        turned on because neither end will take the
                        initiative to send a compressed packet.

            {+|-}f      Turn hardware flow control on or off.  The default
                        setting is off.

            {+|-}i      Turn the suppression of ICMP packets on or off.
                        The default setting is off.

            {+|-}m mtu  Set the maximum transmission unit (mtu) of the
                        network interface to mtu.  The default mtu value
                        is 296.



                          Copyright 1994 Novell, Inc.               Page 2

       slattach(1M)                                            slattach(1M)


                         It is recommended that the mtu value for the
                         TCP/IP packet header be 40 plus some power of 2
                         (for example, 296 = 40 + 2**8).

             {+|-}v      Print or don't print various messages about the
                         interface as it is being brought up.  The default
                         setting is to not print messages.

          Examples
             slattach contty 128.211.8.4 128.211.8.186
             slattach +c /dev/contty percival zapranoth 2400

             Here are the contents of the sample script
             /usr/lib/slip/sliplogin.samp, which may be used as the login
             shell for the answering end of a dialup SLIP connection.  The
             script should be setuid root and executable only by the slip
             login group id.
             #! /bin/ksh -p
             PATH=/usr/sbin:/bin:/usr/bin:
             TTY=`tty`
             LOCAL_ADDRESS=198.242.199.2
             REMOTE_ADDRESS=198.242.199.1
             OPTIONS="+c +v"
             exec slattach $OPTIONS $TTY $LOCAL_ADDRESS $REMOTE_ADDRESS > slip.log 2>&1
             Here is a corresponding uucp Systems file entry:
             hosta Any ACU 9600 555-1234 "" \r ogin:--ogin: sllogin word: secret opyright
       REFERENCES
             cs(1M), ifconfig(1M), netstat(1M), rc2(1M), route(1M),
             SLIP(7), uucico(1M)
             RFC 1055, RFC 1144

















                           Copyright 1994 Novell, Inc.               Page 3