slattach.tproj/slattach.8

   1 .\" Copyright (c) 1986, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)slattach.8  8.2 (Berkeley) 4/1/94
  33 .\"
  34 .Dd April 1, 1994
  35 .Dt SLATTACH 8
  36 .Os BSD 4.3
  37 .Sh NAME
  38 .Nm slattach
  39 .Nd attach serial lines as network interfaces
  40 .Sh SYNOPSIS
  41 .Nm Slattach
  42 .Ar ttyname Op Ar baudrate
  43 .Sh DESCRIPTION
  44 .Nm Slattach
  45 is used to assign a tty line to a network interface,
  46 and to define the network source and destination addresses.
  47 The following operands are supported by
  48 .Nm slattach :
  49 .Bl -tag -width Ar
  50 .It Ar ttyname
  51 Specifies the name of the tty device.
  52 .Ar Ttyname
  53 should be a string of the form
  54 .Ql ttyXX ,
  55 or
  56 .Ql /dev/ttyXX .
  57 .It Ar baudrate
  58 Specifies the speed of the connection. If not specified, the
  59 default of 9600 is used.
  60 .El
  61 .Pp
  62 Only the super-user may attach a network interface.
  63 .Pp
  64 To detach the interface, use
  65 .Dq Li ifconfig interface-name down
  66 after killing off the
  67 .Nm slattach
  68 process.
  69 .Ar Interface-name
  70 is the name that is shown by
  71 .Xr netstat 1
  72 .Sh EXAMPLES
  73 .Bd -literal -offset indent -compact
  74 slattach ttyh8
  75 slattach /dev/tty01 4800
  76 .Ed
  77 .Sh DIAGNOSTICS
  78 Messages indicating the specified interface does not exit, the
  79 requested address is unknown, the user is not privileged and
  80 tried to alter an interface's configuration.
  81 .Sh SEE ALSO
  82 .Xr netstat 1 ,
  83 .Xr netintro 4 ,
  84 .Xr ifconfig 8 ,
  85 .Xr rc 8
  86 .Sh HISTORY
  87 The
  88 .Nm
  89 command appeared in
  90 .Bx 4.3 .