dslinux/user/net-tools/man/en_US arp.8 dnsdomainname.1 domainname.1 ethers.5 hostname.1 ifconfig.8 mii-tool.8 nameif.8 netstat.8 nisdomainname.1 plipconfig.8 rarp.8 route.8 slattach.8 ypdomainname.1

[amadeus]

Update of /cvsroot/dslinux/dslinux/user/net-tools/man/en_US
In directory antilope:/tmp/cvs-serv14346/user/net-tools/man/en_US

Added Files:
	arp.8 dnsdomainname.1 domainname.1 ethers.5 hostname.1 
	ifconfig.8 mii-tool.8 nameif.8 netstat.8 nisdomainname.1 
	plipconfig.8 rarp.8 route.8 slattach.8 ypdomainname.1 
Log Message:
Add some more applications

--- NEW FILE: ethers.5 ---
.TH ETHERS 5 "April 26th, 1996" "" "File formats"
.SH NAME \"{{{roff}}}\"{{{
ethers \- Ethernet address to IP number database
.\"}}}
.SH DESCRIPTION \"{{{
\fB/etc/ethers\fP contains 48 bit Ethernet addresses and their corresponding
IP numbers, one line for each IP number:
.sp
.RS
\fIEthernet-address\fP  \fIIP-number\fP
.RE
.sp
The two items are separated by any number of SPACE and/or TAB char
acters.   A \fB#\fP at the beginning of a line starts a comment
which extends to the end of the line.  The \fIEthernet-address\fP is
written as
.IR x : x : x : x : x : x ,
where \fIx\fP is a hexadecimal number between \fB0\fP and \fBff\fP
which represents one byte of the address, which is in network byte
order (big-endian).  The \fIIP-number\fP may be a hostname which
can be resolved by DNS or a dot separated number.
.\"}}}
.SH EXAMPLES \"{{{
08:00:20:00:61:CA  pal
.\"}}}
.SH FILES \"{{{
/etc/ethers
.\"}}}
.SH "SEE ALSO" \"{{{
rarp(8)
.\"}}}

--- NEW FILE: nameif.8 ---
.TH NAMEIF 8 "18 Oct 2000" "net-tools" "Linux's Administrator's Manual"
.SH NAME
nameif \- name network interfaces based on MAC addresses
.SH SYNOPSIS
.B "nameif [-c configfile] [-s]"
.br
.B "nameif [-c configfile] [-s] {interface macaddress}"
.SH DESCRIPTION
.B nameif 
renames network interfaces based on mac addresses. When no arguments are
given 
.I /etc/mactab
is read. Each line  of it contains an interface name and a Ethernet MAC 
address. Comments are allowed starting with #. 
Otherwise the interfaces specified on the command line are processed.
.I nameif
looks for the interface with the given MAC address and renames it to the
name given.

When the 
.I -s
argument is given all error messages go to the syslog.

When the 
.I -c 
argument is given with a file name that file is read instead of /etc/mactab.

.SH NOTES
.I nameif
should be run before the interface is up, otherwise it'll fail.

.SH FILES
/etc/mactab
.SH BUGS
Only works for Ethernet currently.

--- NEW FILE: ifconfig.8 ---
.TH IFCONFIG 8 "14 August 2000" "net-tools" "Linux Programmer's Manual"
.SH NAME
ifconfig \- configure a network interface
.SH SYNOPSIS
.B "ifconfig [interface]"
.br
.B "ifconfig interface [aftype] options | address ..."
.SH DESCRIPTION
.B Ifconfig
is used to configure the kernel-resident network interfaces.  It is
used at boot time to set up interfaces as necessary.  After that, it
is usually only needed when debugging or when system tuning is needed.
.LP
If no arguments are given,
.B ifconfig
displays the status of the currently active interfaces.  If
a single
.B interface
argument is given, it displays the status of the given interface
only; if a single
.B -a
argument is given, it displays the status of all interfaces, even
those that are down.  Otherwise, it configures an interface.

.SH Address Families
If the first argument after the interface name is recognized as
the name of a supported address family, that address family is
used for decoding and displaying all protocol addresses.  Currently
supported address families include
.B inet
(TCP/IP, default), 
.B inet6
(IPv6),
.B ax25
(AMPR Packet Radio),
.B ddp
(Appletalk Phase 2),
.B ipx
(Novell IPX) and
.B netrom
(AMPR Packet radio).
.SH OPTIONS
.TP
.B interface
The name of the interface.  This is usually a driver name followed by
a unit number, for example
.B eth0
for the first Ethernet interface.
.TP
.B up
This flag causes the interface to be activated.  It is implicitly
specified if an address is assigned to the interface.
.TP
.B down
This flag causes the driver for this interface to be shut down.
.TP
.B "[\-]arp"
Enable or disable the use of the ARP protocol on this interface.
.TP
.B "[\-]promisc"
Enable or disable the
.B promiscuous
mode of the interface.  If selected, all packets on the network will
be received by the interface.
.TP
.B "[\-]allmulti"
Enable or disable 
.B all-multicast
mode.  If selected, all multicast packets on the network will be
received by the interface.
.TP
.B "metric N"
This parameter sets the interface metric.
.TP
.B "mtu N"
This parameter sets the Maximum Transfer Unit (MTU) of an interface.
.TP
.B "dstaddr addr"
Set the remote IP address for a point-to-point link (such as
PPP).  This keyword is now obsolete; use the
.B pointopoint
keyword instead.
.TP
.B "netmask addr"
Set the IP network mask for this interface.  This value defaults to the
usual class A, B or C network mask (as derived from the interface IP
address), but it can be set to any value.
.TP
.B "add addr/prefixlen"
Add an IPv6 address to an interface. 
.TP
.B "del addr/prefixlen"
Remove an IPv6 address from an interface.
.TP
.B "tunnel aa.bb.cc.dd"
Create a new SIT (IPv6-in-IPv4) device, tunnelling to the given destination.
.TP
.B "irq addr"
Set the interrupt line used by this device.  Not all devices can
dynamically change their IRQ setting.
.TP
.B "io_addr addr"
Set the start address in I/O space for this device. 
.TP
.B "mem_start addr"
Set the start address for shared memory used by this device.  Only a
few devices need this.
.TP
.B "media type"
Set the physical port or medium type to be used by the device.  Not
all devices can change this setting, and those that can vary in what
values they support.  Typical values for
.B type
are 
.B 10base2
(thin Ethernet),
.B 10baseT
(twisted-pair 10Mbps Ethernet),
.B AUI 
(external transceiver) and so on.  The special medium type of
.B auto
can be used to tell the driver to auto-sense the media.  Again, not
all drivers can do this.
.TP
.B "[-]broadcast [addr]"
If the address argument is given, set the protocol broadcast
address for this interface.  Otherwise, set (or clear) the
.B IFF_BROADCAST
flag for the interface.
.TP
.B "[-]pointopoint [addr]"
This keyword enables the
.B point-to-point
mode of an interface, meaning that it is a direct link between two
machines with nobody else listening on it.
.br
If the address argument is also given, set the protocol address of
the other side of the link, just like the obsolete
.B dstaddr
keyword does.  Otherwise, set or clear the
.B IFF_POINTOPOINT
flag for the interface. 
.TP
.B hw class address
Set the hardware address of this interface, if the device driver
supports this operation.  The keyword must be followed by the
name of the hardware class and the printable ASCII equivalent of
the hardware address.  Hardware classes currently supported include
.B ether
(Ethernet),
.B ax25
(AMPR AX.25),
.B ARCnet
and
.B netrom
(AMPR NET/ROM).
.TP
.B multicast
Set the multicast flag on the interface. This should not normally be needed
as the drivers set the flag correctly themselves.
.TP
.B address
The IP address to be assigned to this interface.
.TP
.B txqueuelen length
Set the length of the transmit queue of the device. It is useful to set this
to small values for slower devices with a high latency (modem links, ISDN)
to prevent fast bulk transfers from disturbing interactive traffic like
telnet too much. 
.SH NOTES
Since kernel release 2.2 there are no explicit interface statistics for
alias interfaces anymore. The statistics printed for the original address
are shared with all alias addresses on the same device. If you want per-address
statistics you should add explicit accounting
rules for the address using the 
.BR ipchains(8)
command.
.LP
Interrupt problems with Ethernet device drivers fail with EAGAIN. See
.I http://cesdis.gsfc.nasa.gov/linux/misc/irq-conflict.html
for more information.
.SH FILES
.I /proc/net/socket 
.br
.I /proc/net/dev
.br
.I /proc/net/if_inet6
.SH BUGS
While appletalk DDP and IPX addresses will be displayed they cannot be
altered by this command.
.SH SEE ALSO
route(8), netstat(8), arp(8), rarp(8), ipchains(8)
.SH AUTHORS
Fred N. van Kempen, <waltje at uwalt.nl.mugnet.org>
.br
Alan Cox, <Alan.Cox at linux.org>
.br
Phil Blundell, <Philip.Blundell at pobox.com>
.br
Andi Kleen

--- NEW FILE: domainname.1 ---
.so man1/hostname.1

--- NEW FILE: arp.8 ---
.TH ARP 8 "5 Jan 1999" "net-tools" "Linux Programmer's Manual"
.SH NAME
arp \- manipulate the system ARP cache
.SH SYNOPSIS
.B arp 
.RB [ \-vn ] 
.RB [ "\-H type" ] 
.RB [ "-i if" ] 
.B -a 
.RB [ hostname ]
.PP
.B arp 
.RB [ \-v ]
.RB [ "\-i if" ] 
.B "\-d hostname"
.RB [ pub ]
.PP
.B arp 
.RB [ \-v ] 
.RB [ "\-H type" ] 
.RB [ "\-i if" ] 
.B -s hostname hw_addr
.RB [ temp ] 
.PP
.B arp 
.RB [ \-v ] 
.RB [ "\-H type" ] 
.RB [ "\-i if" ] 
.B -s hostname hw_addr
.RB [ "netmask nm" ] 
.B pub
.PP
.B arp 
.RB [ \-v ] 
.RB [ "\-H type" ] 
.RB [ "\-i if" ] 
.B -Ds hostname ifa
.RB [ "netmask nm" ] 
.B pub
.PP
.B arp 
.RB [ \-vnD ]
.RB [ "\-H type" ] 
.RB [ "-i if" ]
.B -f [filename]

.SH DESCRIPTION
.B Arp
manipulates the kernel's ARP cache in various ways.  The primary options
are clearing an address mapping entry and manually setting up one.  For
debugging purposes, the
.B arp
program also allows a complete dump of the ARP cache.
.SH OPTIONS
.TP
.B "\-v, \-\-verbose"
Tell the user what is going on by being verbose.
.TP
.B "\-n, \-\-numeric"
shows numerical addresses instead of trying to determine symbolic host, port
or user names.
.TP
.B "\-H type, \-\-hw-type type"
When setting or reading the ARP cache, this optional parameter tells
.B arp
which class of entries it should check for.  The default value of
this parameter is
.B ether
(i.e. hardware code 0x01 for IEEE 802.3 10Mbps Ethernet).
Other values might include network technologies such as
.RB "ARCnet (" arcnet ")"
,
.RB "PROnet (" pronet ")"
,
.RB "AX.25 (" ax25 ")"
and
.RB "NET/ROM (" netrom ")."
.TP
.B "\-a [hostname], \-\-display [hostname]"
Shows the entries of the specified hosts.  If the
.B hostname
parameter is not used,
.B all
entries will be displayed.
.TP
.B "\-d hostname, \-\-delete hostname"
Remove any entry for the specified host.  This can be used if the
indicated host is brought down, for example.
.TP
.B "\-D, \-\-use-device"
Use the interface
.BR ifa "'s"
hardware address.
.TP
.B "\-i If, \-\-device If"
Select an interface. When dumping the ARP cache only entries matching
the specified interface will be printed. When setting a permanent or
.B temp
ARP entry this interface will be associated with the entry; if this
option is not used, the kernel will guess based on the routing
table. For
.B pub
entries the specified interface is the interface on which ARP requests will
be answered. 
.br
.B NOTE:
This has to be different from the interface to which the IP
datagrams will be routed.
.TP
.B "\-s hostname hw_addr, \-\-set hostname"
Manually create an ARP address mapping entry for host
.B hostname
with hardware address set to
.B hw_addr
.  The format of the hardware address is dependent on the hardware
class, but for most classes one can assume that the usual presentation
can be used.  For the Ethernet class, this is 6 bytes in hexadecimal,
separated by colons. When adding proxy arp entries (that is those with
the 
.BR pub lish 
flag set a 
.B netmask 
may be specified to proxy arp for entire subnets. This is not good
practice, but is supported by older kernels because it can be
useful. If the
.B temp
flag is not supplied entries will be permanent stored into the ARP
cache.
.br
.B NOTE:
As of kernel 2.2.0 it is no longer possible to set an ARP entry for an 
entire subnet. Linux instead does automagic proxy arp when a route
exists and it is forwarding. See 
.BR arp (7)
for details.
.TP
.B "\-f filename, \-\-file filename"
Similar to the
.B \-s
option, only this time the address info is taken from file
.B filename
.  This can be used if ARP entries for a lot of hosts have to be
set up.  The name of the data file is very often
.IR /etc/ethers , 
but this is not official. If no filename is specified /etc/ethers
is used as default.
.sp 1
The format of the file is simple; it
only contains ASCII text lines with a hostname, and a hardware
address separated by whitespace. Additionally the 
.BR "pub" , " temp" " and" " netmask"
flags can be used.
.LP
In all places where a
.B hostname
is expected, one can also enter an
.B "IP address"
in dotted-decimal notation.
.P
As a special case for compatibility the order of the hostname and 
the hardware address can be exchanged.
.LP 
Each complete entry in the ARP cache will be marked with the
.B C
flag. Permanent entries are marked with
.B M
and published entries have the
.B P
flag.
.SH FILES
.I /proc/net/arp,
.br
.I /etc/networks
.br
.I /etc/hosts
.br
.I /etc/ethers
.SH SEE ALSO
rarp(8), route(8), ifconfig(8), netstat(8)
.SH AUTHORS
Fred N. van Kempen, <waltje at uwalt.nl.mugnet.org> with a lot of improvements
from net-tools Maintainer Bernd Eckenfels <net-tools at lina.inka.de>.

--- NEW FILE: mii-tool.8 ---
.\" Copyright (C) 2000 David A. Hinds -- dhinds at pcmcia.sourceforge.org
.\" mii-tool.8 1.5 2000/04/25 22:58:19
.\"
.TH MII-TOOL 8 "2000/04/25 22:58:19" "net-tools"

.SH NAME
mii-tool \- view, manipulate media-independent interface status

.SH SYNOPSIS
.B mii-tool
[\fB\-v\fR, \fB\-\-verbose\fR]
[\fB\-V\fR, \fB\-\-version\fR]
[\fB\-R\fR, \fB\-\-reset\fR]
[\fB\-r\fR, \fB\-\-restart\fR]
[\fB\-w\fR, \fB\-\-watch\fR]
[\fB\-l\fR, \fB\-\-log\fR]
[\fB\-A\fR, \fB\-\-advertise=\fImedia,...\fR]
[\fB\-F\fR, \fB\-\-force=\fImedia\fR]
.RI [ "interface\ ..." ]

.SH DESCRIPTION
This utility checks or sets the status of a network interface's Media
Independent Interface (MII) unit.  Most fast ethernet adapters use an
MII to autonegotiate link speed and duplex setting.
.PP
Most intelligent network devices use an autonegotiation protocol to
communicate what media technologies they support, and then select the
fastest mutually supported media technology.  The \fB\-A\fR or
\fB\-\-advertise\fR options can be used to tell the MII to only
advertise a subset of its capabilities.  Some passive devices, such as
single-speed hubs, are unable to autonegotiate.  To handle such
devices, the MII protocol also allows for establishing a link by
simply detecting either a 10baseT or 100baseT link beat.  The \fB\-F\fR
or \fB\-\-force\fR options can be used to force the MII to operate in
one mode, instead of autonegotiating.  The \fB\-A\fR and \fB-F\fR
options are mutually exclusive.
.PP
The default short output reports the negotiated link speed and link
status for each interface.  If an interface or interfaces are not
specified on the command line, then \fBmii-tool\fR will check any
available interfaces from \fBeth0\fR through \fBeth7\fR.
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Display more detailed MII status information.  If used twice, also
display raw MII register contents.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display program version information.
.TP
\fB\-R\fR, \fB\-\-reset\fR
Reset the MII to its default configuration.
.TP
\fB\-r\fR, \fB\-\-restart\fR
Restart autonegotiation.
.TP
\fB\-w\fR, \fB\-\-watch\fR
Watch interface(s) and report changes in link status.  The MII
interfaces are polled at one second intervals.
.TP
\fB\-l\fR, \fB\-\-log\fR
Used with \fB-w\fR, records link status changes in the system log
instead of printing on standard output.
.TP
\fB\-F\fI media\fR, \fB\-\-force=\fImedia\fR
Disable autonegotiation, and force the MII to either \fB100baseTx-FD\fR,
\fB100baseTx-HD\fR, \fB10baseT-FD\fR, or \fB10baseT-HD\fR operation.
.TP
\fB\-A\fI media,...\fR, \fB\-\-advertise=\fImedia,...\fR
Enable and restart autonegotiation, and advertise only the specified
media technologies.  Multiple technologies should be separated by
commas.  Valid media are \fB100baseT4\fR, \fB100baseTx-FD\fR,
\fB100baseTx-HD\fR, \fB10baseT-FD\fR, and \fB10baseT-HD\fR.

.SH AUTHORS
David Hinds \- dhinds at pcmcia.sourceforge.org
.br
Donald Becker \- becker at scyld.com

--- NEW FILE: dnsdomainname.1 ---
.so man1/hostname.1

--- NEW FILE: rarp.8 ---
.TH RARP 8 "4 August 1997" "net-tools" "Linux Programmer's Manual"
.SH NAME
rarp \- manipulate the system RARP table
.SH SYNOPSIS
.B "rarp [-V] [--version] [-h] [--help]"
.br
.B "rarp -a"
.br
.B "rarp [-v] -d hostname ..."
.br
.B "rarp [-v] [-t type] -s hostname hw_addr"
.SH NOTE
.P
This program is obsolete.  From version 2.3, the Linux kernel 
no longer contains RARP support.  For a replacement RARP daemon, see
.I
ftp://ftp.dementia.org/pub/net-tools
.SH DESCRIPTION
.B Rarp
manipulates the kernel's RARP table in various ways.  The primary options
are clearing an address mapping entry and manually setting up one.  For
debugging purposes, the
.B rarp
program also allows a complete dump of the RARP table.
.SH OPTIONS
.TP
.B \-V
Display the version of RARP in use.
.TP
.B \-v
Tell the user what is going on by being verbose.
.TP
.B "\-t type"
When setting or reading the RARP table, this optional parameter tells
.B rarp
which class of entries it should check for.  The default value of
this parameter is
.B ether
(i.e. hardware code
.B 0x01
for
.B "IEEE 802.3 10Mbps Ethernet".
Other values might include network technologies such as
.B AX.25 (ax25)
and
.B NET/ROM (netrom).
.TP
.B "\-a"
.TP
.B "\-\-list"
Lists the entries in the RARP table.
.TP
.B "\-d hostname"
.TP
.B "\-\-delete hostname"
Remove all RARP entries for the specified host.
.TP
.B "\-s hostname hw_addr"
.TP
.B "\-\-set hostname hw_addr"
Create a RARP address mapping entry for host
.B hostname
with hardware address set to
.B hw_addr
.  The format of the hardware address is dependent on the hardware
class, but for most classes one can assume that the usual presentation
can be used.  For the Ethernet class, this is 6 bytes in hexadecimal,
separated by colons.
.SH WARNING
Some systems (notably older Suns) assume that the host replying to
a RARP query can also provide other remote boot services. Therefore 
never gratuitously add rarp entries unless you wish to meet the wrath
of the network administrator.
.SH FILES
.I /proc/net/rarp,
.SH SEE ALSO
arp(8), route(8), ifconfig(8), netstat(8)
.SH AUTHORS
Ross D. Martin, <martin at trcsun3.eas.asu.edu>
.br
Fred N. van Kempen, <waltje at uwalt.nl.mugnet.org>
.br
Phil Blundell, <Philip.Blundell at pobox.com>

--- NEW FILE: hostname.1 ---
.TH HOSTNAME 1 "28 Jan 1996" "net-tools" "Linux Programmer's Manual"

.SH NAME
hostname \- show or set the system's host name
.br
domainname \- show or set the system's NIS/YP domain name
.br
dnsdomainname \- show the system's DNS domain name
.br
nisdomainname \- show or set system's NIS/YP domain name
.br
ypdomainname \- show or set the system's NIS/YP domain name
.br
nodename \- show or set the system's DECnet node name

.SH SYNOPSIS
.B hostname
.RB [ \-v ]
.RB [ \-a ]
.RB [ \-\-alias ]
.RB [ \-d ]
.RB [ \-\-domain ]
.RB [ \-f ]
.RB [ \-\-fqdn ]
.RB [ \-i ]
.RB [ \-\-ip-address ]
.RB [ \-\-long ]
.RB [ \-s ]
.RB [ \-\-short ]
.RB [ \-y ]
.RB [ \-\-yp ]
.RB [ \-\-nis ]
.RB [ \-n ]
.RB [ \-\-node ]

.PP
.B hostname 
.RB [ \-v ]
.RB [ \-F\ filename ]
.RB [ \-\-file\ filename ]
.RB [ hostname ]

.PP
.B domainname
.RB [ \-v ]
.RB [ \-F\ filename ]
.RB [ \-\-file\ filename ]
.RB [ name ]

.PP 
.B nodename
.RB [ \-v ]
.RB [ \-F\ filename ]
.RB [ \-\-file\ filename ]
.RB [ name ]

.PP
.B hostname
.RB [ \-v ]
.RB [ \-h ]
.RB [ \-\-help ]
.RB [ \-V ]
.RB [ \-\-version ]

.PP
.B dnsdomainname
.RB [ \-v ]
.br
.B nisdomainname
.RB [ \-v ]
.br
.B ypdomainname
.RB [ \-v ]

.SH DESCRIPTION
.B Hostname
is the program that is used to either set or display
the current host, domain or node name of the system.  These names are used
by many of the networking programs to identify the machine. The domain 
name is also used by NIS/YP.

.SS "GET NAME"
When called without any arguments, the program displays the current
names:

.LP
.B hostname
will print the name of the system as returned by the
.BR gethostname (2)
function.

.LP
.B "domainname, nisdomainname, ypdomainname"
will print the name of the system as returned by the
.BR getdomainname (2)
function. This is also known as the YP/NIS domain name of the system.

.LP
.B nodename
will print the DECnet node name of the system as returned by the
.BR getnodename (2)
function.

.LP
.B dnsdomainname
will print the domain part of the FQDN (Fully Qualified Domain Name). The
complete FQDN of the system is returned with
.BR "hostname \-\-fqdn" .

.SS "SET NAME"
When called with one argument or with the 
.B \-\-file
option, the commands set the host name, the NIS/YP domain name or
the node name. 

.LP
Note, that only the super-user can change the names. 

.LP
It is not possible to set the FQDN or the DNS domain name with the 
.B dnsdomainname 
command (see 
.B "THE FQDN"
below).

.LP
The host name is usually set once at system startup in
.I /etc/rc.d/rc.inet1
or
.I /etc/init.d/boot
(normally by reading the contents of a file which contains
the host name, e.g. 
.IR /etc/hostname ).

.SS THE FQDN
You can't change the FQDN (as returned by 
.BR "hostname \-\-fqdn" ) 
or the DNS domain name (as returned by
.BR "dnsdomainname" ) 
with this command. The FQDN of the system is the name that the
.BR resolver (3)
returns for the host name. 

.LP
Technically: The FQDN is the name
.BR gethostbyname (2)
returns for the host name returned by
.BR gethostname (2).
The DNS domain name is the part after the first dot.
.LP
Therefore it depends on the configuration (usually in 
.IR /etc/host.conf )
how you can change it. Usually (if the hosts file is parsed before DNS or 
NIS) you can change it in 
.IR /etc/hosts .


.SH OPTIONS
.TP
.I "\-a, \-\-alias"
Display the alias name of the host (if used).
.TP
.I "\-d, \-\-domain"
Display the name of the DNS domain. Don't use the command
.B domainname
to get the DNS domain name because it will show the NIS domain name and
not the DNS domain name. Use
.B dnsdomainname 
instead.
.TP
.I "\-F, \-\-file filename"
Read the host name from the specified file. Comments (lines starting with
a `#') are ignored.
.TP
.I "\-f, \-\-fqdn, \-\-long"
Display the FQDN (Fully Qualified Domain Name). A FQDN consists of a
short host name and the DNS domain name. Unless you are using bind or NIS
for host lookups you can change the FQDN and the DNS domain name (which is
part of the FQDN) in the \fI/etc/hosts\fR file.
.TP
.I "\-h, \-\-help"
Print a usage message and exit.
.TP
.I "\-i, \-\-ip-address"
Display the IP address(es) of the host.
.TP
.I "\-n, \-\-node"
Display the DECnet node name. If a parameter is given (or
.B \-\-file name
) the root can also set a new node name.
.TP
.I "\-s, \-\-short"
Display the short host name. This is the host name cut at the first dot.
.TP
.I "\-V, \-\-version"
Print version information on standard output and exit successfully.
.TP
.I "\-v, \-\-verbose"
Be verbose and tell what's going on.
.TP
.I "\-y, \-\-yp, \-\-nis"
Display the NIS domain name. If a parameter is given (or 
.B \-\-file name
) then root can also set a new NIS domain.
.SH FILES
.B /etc/hosts
.SH AUTHOR
Peter Tobias, <tobias at et-inf.fho-emden.de>
.br
Bernd Eckenfels, <net-tools at lina.inka.de> (NIS and manpage).
.br
Steve Whitehouse, <SteveW at ACM.org> (DECnet support and manpage).


--- NEW FILE: slattach.8 ---
.TH SLATTACH 8 "12 Feb 1994" "" ""
.SH NAME
slattach \- attach a network interface to a serial line
.SH SYNOPSIS
.B "slattach [-dehlLmnqv] [-c command] [-p proto] [-s speed] [tty]"
.br
.SH DESCRIPTION
.B Slattach
is a tiny little program that can be used to put a normal terminal
("serial") line into one of several "network" modes, thus allowing
you to use it for point-to-point links to other computers.
.SH OPTIONS
.TP
.B "[-c command]"
Execute
.B command
when the line is hung up. This can be used to run scripts or re-establish
connections when a link goes down.
.TP
.B "[-d]"
Enable debugging output.  Useful when determining why a given
setup doesn't work.
.TP
.B "[-h]"
Exit when the carrier is lost. This works on both /dev/tty and /dev/cua
devices by directly monitoring the carrier status every 15 seconds.
.B "[-v]"
Enable verbose output.  Useful in shell scripts.
.TP
.B "[-q]"
Operate in quiet mode - no messages at all.
.TP
.B "[-l]"
Create an UUCP-style lockfile for the device in /var/lock.
.TP
.B "[-n]"
Equivalent to the "mesg n" command.
.TP
.B "[-m]"
Do \fBnot\fP initialize the line into 8 bits raw mode.
.TP
.B "[-e]"
Exit right after initializing device, instead of waiting for the
line to hangup.
.TP
.B "[-L]"
Enable 3 wire operation. The terminal is moved into CLOCAL mode, 
carrier watching is disabled.
.TP
.B "[-p proto]"
Set a specific kind of protocol to use on the line.  The default
is set to
.B "cslip"
, i.e. compressed SLIP.  Other possible values are
.B "slip"
(normal SLIP), 
.B "adaptive"
(adaptive CSLIP/SLIP),
.B "ppp"
(Point-to-Point Protocol)
and
.B "kiss"
(a protocol used for communicating with AX.25 packet radio terminal node controllers).
The special argument
.B "tty"
can be used to put the device back into normal serial operation.
Using 'ppp' mode is not normally useful as ppp requires an additional ppp daemon
.B pppd
to be active on the line. For kiss connections the 
.B axattach
program should be used.
.TP
.B "[-s speed]"
Set a specific line speed, other than the default.
.PP
If no arguments are given, the current terminal line (usually: the
login device) is used.  Otherwise, an attempt is made to claim the
indicated terminal port, lock it, and open it.
.SH FILES
.I /dev/cua* /var/lock/LCK.*
.SH BUGS
None known.
.SH SEE ALSO
axattach(8), dip(8) pppd(8), sliplogin(8).
.SH AUTHORS
Fred N. van Kempen, <waltje at uwalt.nl.mugnet.org>
.br
Alan Cox, <Alan.Cox at linux.org>
.br
Miquel van Smoorenburg, <miquels at drinkel.ow.org>
.br
George Shearer, <gshearer at one.net>
.br
Yossi Gottlieb, <yogo at math.tau.ac.il>
.br

--- NEW FILE: route.8 ---
.TH ROUTE 8 "2 January 2000" "net-tools" "Linux Programmer's Manual"
.SH NAME
route \- show / manipulate the IP routing table
.SH SYNOPSIS
.B route
.RB [ \-CFvnee ]
.TP
.B route 
.RB [ \-v ]
.RB [ \-A
family] 
.B add 
.RB [ \-net | \-host ] 
target 
.RB [ netmask 
Nm] 
.RB [ gw 
Gw] 
.RB [ metric 
N] 
.RB [ mss 
M] 
.RB [ window 
W] 
.RB [ irtt 
I]
.RB [ reject ]
.RB [ mod ]
.RB [ dyn ] 
.RB [ reinstate ] 
.RB [[ dev ] 
If]
.TP
.B route 
.RB [ \-v ] 
.RB [ \-A
family]
.B del 
.RB [ \-net | \-host ] 
target 
.RB [ gw 
Gw] 
.RB [ netmask 
Nm] 
.RB [ metric 
N] 
.RB [[ dev ]
If]
.TP
.B route 
.RB [ \-V ] 
.RB [ \-\-version ]
.RB [ \-h ]
.RB [ \--help ]
.SH DESCRIPTION
.B Route
manipulates the kernel's IP routing tables.  Its primary use is to set
up static routes to specific hosts or networks via an interface after
it has been configured with the
.BR ifconfig (8)
program.

When the
.B add
or
.B del
options are used,
.B route
modifies the routing tables.  Without these options,
.B route
displays the current contents of the routing tables.

.SH OPTIONS
.TP
.B \-A family
use the specified address family (eg `inet'; use `route --help' for a full 
list).

.TP 
.B -F
operate on the kernel's FIB (Forwarding Information Base) routing
table. 
This is the default.
.TP 
.B -C
operate on the kernel's routing cache.

.TP
.B \-v
select verbose operation.
.TP
.B \-n
show numerical addresses instead of trying to determine symbolic host
names. This is useful if you are trying to determine why the route to your
nameserver has vanished.
.TP
.B \-e
use
.BR netstat (8)-format
for displaying the routing table.
.B \-ee 
will generate a very long line with all parameters from the routing table.

.TP
.B del
delete a route.
.TP 
.B add 
add a new route.
.TP
.B target
the destination network or host. You can provide IP addresses in dotted
decimal or host/network names.
.TP
.B \-net
the
.B target
is a network.
.TP
.B -host
the
.B target 
is a host.
.TP
.B netmask NM
when adding a network route, the netmask to be used.
.TP
.B gw GW
route packets via a gateway.
.B NOTE:
The specified gateway must be reachable first. This usually means that
you have to set up a static route to the gateway beforehand. If you specify
the address of one of your local interfaces, it will be used to decide about
the interface to which the packets should be routed to. This is a BSDism
compatibility hack.
.TP
.B metric M
set the metric field in the routing table (used by routing daemons) to M.
.TP 
.B mss M
set the TCP Maximum Segment Size (MSS) for connections over this route
to M bytes. 
The default is the device MTU minus headers, or a lower MTU when path mtu 
discovery occured. This setting can be used to force smaller TCP packets on the
other end when path mtu discovery does not work (usually because of
misconfigured firewalls that block ICMP Fragmentation Needed)
.TP 
.B window W 
set the TCP window size for connections over this route to W
bytes. This is typically only used on AX.25 networks and with drivers
unable to handle back to back frames.
.TP
.B irtt I
set the initial round trip time (irtt) for TCP connections over this
route to I milliseconds (1-12000). This is typically only used on
AX.25 networks. If omitted the RFC 1122 default of 300ms is used.
.TP
.B reject
install a blocking route, which will force a route lookup to fail.
This is for example used to mask out networks before using the default
route.  This is NOT for firewalling.
.TP
.B mod, dyn, reinstate
install a dynamic or modified route. These flags are for diagnostic
purposes, and are generally only set by routing daemons.
.TP
.B dev If
force the route to be associated with the specified device, as the
kernel will otherwise try to determine the device on its own (by
checking already existing routes and device specifications, and where
the route is added to). In most normal networks you won't need this.

If 
.B dev If
is the last option on the command line, the word 
.B dev
may be omitted, as it's the default. Otherwise the order of the route
modifiers (metric - netmask - gw - dev) doesn't matter.

.SH EXAMPLES
.TP
.B route add -net 127.0.0.0
adds the normal loopback entry, using netmask 255.0.0.0 (class A net,
determined from the destination address) and associated with the 
"lo" device (assuming this device was prviously set up correctly with
.BR ifconfig (8)). 

.TP 
.B route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0
adds a route to the network 192.56.76.x via 
"eth0". The Class C netmask modifier is not really necessary here because
192.* is a Class C IP address. The word "dev" can be omitted here. 

.TP
.B route add default gw mango-gw
adds a default route (which will be used if no other route matches).
All packets using this route will be gatewayed through "mango-gw". The
device which will actually be used for that route depends on how we
can reach "mango-gw" - the static route to "mango-gw" will have to be
set up before. 

.TP
.B route add ipx4 sl0
Adds the route to the "ipx4" host via the SLIP interface (assuming that
"ipx4" is the SLIP host).

.TP
.B route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4
This command adds the net "192.57.66.x" to be gatewayed through the former
route to the SLIP interface.

.TP
.B route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0
This is an obscure one documented so people know how to do it. This sets
all of the class D (multicast) IP routes to go via "eth0". This is the
correct normal configuration line with a multicasting kernel. 

.TP
.B route add -net 10.0.0.0 netmask 255.0.0.0 reject
This installs a rejecting route for the private network "10.x.x.x."

.LP
.SH OUTPUT
The output of the kernel routing table is organized in the following columns
.TP
.B Destination     
The destination network or destination host.
.TP
.B Gateway
The gateway address or '*' if none set.
.TP
.B Genmask         
The netmask for the destination net; '255.255.255.255' for a host destination
and '0.0.0.0' for the 
.B default
route.
.TP
.B Flags 
Possible flags include
.br
.B U
(route is
.BR up )
.br
.B H
(target is a
.BR host )
.br
.B G
(use
.BR gateway )
.br
.B R
.RB ( reinstate
route for dynamic routing)
.br
.B D
.RB ( dynamically
installed by daemon or redirect)
.br
.B M
.RB ( modified
from routing daemon or redirect)
.br
.B A
(installed by
.BR addrconf )
.br
.B C
.RB ( cache
entry)
.br
.B !
.RB ( reject
route)
.TP
.B Metric 
The 'distance' to the target (usually counted in hops). It is not used by
recent kernels, but may be needed by routing daemons.
.TP
.B Ref    
Number of references to this route. (Not used in the Linux kernel.)
.TP
.B Use
Count of lookups for the route.  Depending on the use of -F and -C this will
be either route cache misses (-F) or hits (-C).
.TP
.B Iface
Interface to which packets for this route will be sent.
.TP
.B MSS 
Default maximum segement size for TCP connections over this route.
.TP
.B Window  
Default window size for TCP connections over this route.
.TP
.B irtt
Initial RTT (Round Trip Time). The kernel uses this to guess about the best
TCP protocol parameters without waiting on (possibly slow) answers.
.TP
.B HH (cached only)
The number of ARP entries and cached routes that refer to the hardware
header cache for the cached route. This will be \-1 if a hardware
address is not needed for the interface of the cached route (e.g. lo).
.TP
.B Arp (cached only)
Whether or not the hardware address for the cached route is up to date.
.LP
.SH FILES
.I /proc/net/ipv6_route
.br
.I /proc/net/route
.br
.I /proc/net/rt_cache
.LP
.SH SEE ALSO
.I ifconfig(8), netstat(8), arp(8), rarp(8)
.LP
.SH HISTORY
.B Route
for Linux was originally written by Fred N.  van Kempen,
<waltje at uwalt.nl.mugnet.org> and then modified by Johannes Stille and
Linus Torvalds for pl15. Alan Cox added the mss and window options for
Linux 1.1.22. irtt support and merged with netstat from Bernd Eckenfels.
.SH AUTHOR
Currently maintained by Phil Blundell <Philip.Blundell at pobox.com>.

--- NEW FILE: nisdomainname.1 ---
.so man1/hostname.1

--- NEW FILE: netstat.8 ---
.\"
.\" netstat.8 
.\"
.\" Original: (mdw at tc.cornell.edu & dc6iq at insu1.etec.uni-karlsruhe.de)
.\"
.\" Modified: Bernd.Eckenfels at inka.de
.\" Modified: Andi Kleen ak at muc.de 
.\" Modified: Tuan Hoang tqhoang at bigfoot.com 
.\"
.\"
.TH NETSTAT 8 "19 December 2000" "net-tools" "Linux Programmer's Manual"

.SH NAME
netstat \- Print network connections, routing tables, interface statistics, masquerade connections, and multicast memberships

.SH SYNOPSIS

.B netstat 
.RI [ address_family_options ]
.RB [ \-\-tcp | \-t ]
.RB [ \-\-udp | \-u ]
.RB [ \-\-raw | \-w ]
.RB [ \-\-listening | \-l ]
.RB [ \-\-all | \-a ]
.RB [ \-\-numeric | \-n ]
.RB [ \-\-numeric-hosts ] [ \-\-numeric-ports ] [ \-\-numeric-ports ]
.RB [ \-\-symbolic | \-N ]
.RB [ \-\-extend | \-e  [ \-\-extend | \-e] ]
.RB [ \-\-timers | \-o ]
.RB [ \-\-program | \-p ]
.RB [ \-\-verbose | \-v ]
.RB [ \-\-continuous | \-c]
.P
.B netstat 
.RB { \-\-route | \-r }
.RI [ address_family_options ]
.RB [ \-\-extend | \-e  [ \-\-extend | \-e] ]
.RB [ \-\-verbose | \-v ]
.RB [ \-\-numeric | \-n ]
.RB [ \-\-numeric-hosts ] [ \-\-numeric-ports ] [ \-\-numeric-ports ]
.RB [ \-\-continuous | \-c]
.P
.B netstat
.RB { \-\-interfaces | \-i }
.RI [ iface ]
.RB [ \-\-all | \-a ]
.RB [ \-\-extend | \-e  [ \-\-extend | \-e] ]
.RB [ \-\-verbose | \-v ]
.RB [ \-\-program | \-p ]
.RB [ \-\-numeric | \-n ]
.RB [ \-\-numeric-hosts ] [ \-\-numeric-ports ] [ \-\-numeric-ports ]
.RB [ \-\-continuous | \-c]
.P
.B netstat
.RB { \-\-groups | \-g }
.RB [ \-\-numeric | \-n ]
.RB [ \-\-numeric-hosts ] [ \-\-numeric-ports ] [ \-\-numeric-ports ]
.RB [ \-\-continuous | \-c]
.P
.B netstat
.RB { \-\-masquerade | \-M }
.RB [ \-\-extend | \-e ]
.RB [ \-\-numeric | \-n ]
.RB [ \-\-numeric-hosts ] [ \-\-numeric-ports ] [ \-\-numeric-ports ]
.RB [ \-\-continuous | \-c]
.P
.B netstat
.RB { \-\-statistics | -s }
.RB [ \-\-tcp | \-t ]
.RB [ \-\-udp | \-u ]
.RB [ \-\-raw | \-w ]
.P
.B netstat 
.RB { \-\-version | \-V }
.P
.B netstat 
.RB { \-\-help | \-h }
.P
.IR address_family_options :
.PP
.RB [ \-\-protocol= { inet , unix , ipx , ax25 , netrom , ddp }[, ...] ]
.RB [ \-\-unix | \-x ] 
.RB [ \-\-inet | \-\-ip ]
.RB [ \-\-ax25 ]
.RB [ \-\-ipx ] 
.RB [ \-\-netrom ]
.RB [ \-\-ddp ]

.SH DESCRIPTION
.B Netstat
prints information about the Linux networking subsystem.  The type of
information printed is controlled by the first argument, as follows:
.SS (none)
By default,
.B
netstat 
displays a list of open sockets.  If you don't specify any
address families, then the active sockets of all configured address
families will be printed.
.SS "\-\-route , \-r"
Display the kernel routing tables.
.SS "\-\-groups , \-g"
Display multicast group membership information for IPv4 and IPv6.
.SS "\-\-interface=\fIiface \fR, \fB\-i"
Display a table of all network interfaces, or the specified
.IR iface ) .
.SS "\-\-masquerade , \-M"
Display a list of masqueraded connections.
.SS "\-\-statistics , \-s"
Display summary statistics for each protocol.
.SH OPTIONS
.SS "\-\-verbose , \-v"
Tell the user what is going on by being verbose. Especially print some
useful information about unconfigured address families.
.SS "\-\-numeric , \-n"
Show numerical addresses instead of trying to determine symbolic host, port
or user names.
.SS "\-\-numeric-hosts"
shows numerical host addresses but does not affect the resolution of
port or user names.
.SS "\-\-numeric-ports"
shows numerical port numbers but does not affect the resolution of
host or user names.
.SS "\-\-numeric-users"
shows numerical user IDs but does not affect the resolution of host or
port names.

.SS "\-\-protocol=\fIfamily \fR, \fB\-A"
Specifies the address families (perhaps better described as low level
protocols) for which connections are to be shown.
.I family 
is a comma (',') separated list of address family keywords like
.BR inet , 
.BR unix , 
.BR ipx , 
.BR ax25 , 
.BR netrom ,
and
.BR ddp .
This has the same effect as using the 
.BR \-\-inet ,
.BR \-\-unix " (" \-x ),
.BR \-\-ipx ,
.BR \-\-ax25 ,
.BR \-\-netrom ,
and
.B \-\-ddp 
options.
.P
The address family
.B inet
includes raw, udp and tcp protocol sockets.
.SS "\-c, \-\-continuous"
This will cause
.B netstat
to print the selected information every second continuously.
.SS "\-e, \-\-extend"
Display additional information.  Use this option twice for maximum detail.
.SS "\-o, \-\-timers"
Include information related to networking timers.
.SS "\-p, \-\-program"
Show the PID and name of the program to which each socket belongs.
.SS "\-l, \-\-listening"
Show only listening sockets.  (These are omitted by default.)
.SS "\-a, \-\-all"
Show both listening and non-listening sockets.  With the
.B --interfaces
option, show interfaces that are not marked 
.SS "\-F"
Print routing information from the FIB.  (This is the default.)
.SS "\-C"
Print routing information from the route cache.
.IR UP .
.P
.SH OUTPUT
.P
.SS Active Internet connections \fR(TCP, UDP, raw)\fR
.SS "Proto" 
The protocol (tcp, udp, raw) used by the socket. 
.SS "Recv-Q"
The count of bytes not copied by the user program connected to this socket.
.SS "Send-Q"
The count of bytes not acknowledged by the remote host.
.SS "Local Address" 
Address and port number of the local end of the socket.  Unless the
.BR \-\-numeric " (" \-n )
option is specified, the socket address is resolved to its canonical
host name (FQDN), and the port number is translated into the
corresponding service name.
.SS "Foreign Address"
Address and port number of the remote end of the socket.
Analogous to "Local Address."
.SS "State"
The state of the socket. Since there are no states in raw mode and usually no
states used in UDP, this column may be left blank. Normally this can be one
of several values:
.TP
.I
ESTABLISHED
The socket has an established connection.
.TP
.I
SYN_SENT
The socket is actively attempting to establish a connection.
.TP
.I
SYN_RECV
A connection request has been received from the network.
.TP
.I
FIN_WAIT1
The socket is closed, and the connection is shutting down.
.TP
.I
FIN_WAIT2
Connection is closed, and the socket is waiting for a shutdown from the
remote end.
.TP
.I
TIME_WAIT
The socket is waiting after close to handle packets still in the network.
.TP
.I
CLOSED
The socket is not being used.
.TP
.I
CLOSE_WAIT
The remote end has shut down, waiting for the socket to close.
.TP
.I
LAST_ACK
The remote end has shut down, and the socket is closed. Waiting for
acknowledgement.
.TP
.I
LISTEN
The socket is listening for incoming connections.  Such sockets are 
not included in the output unless you specify the 
.BR \-\-listening " (" \-l )
or 
.BR \-\-all " (" \-a )
option.
.TP
.I
CLOSING
Both sockets are shut down but we still don't have all our data
sent.
.TP
.I
UNKNOWN
The state of the socket is unknown.
.SS "User"
The username or the user id (UID) of the owner of the socket.
.SS "PID/Program name"
Slash-separated pair of the process id (PID) and process name of the 
process that owns the socket.
.B --program
causes this column to be included.  You will also need
.I superuser
privileges to see this information on sockets you don't own.  This
identification information is not yet available for IPX sockets.
.SS "Timer"
(this needs to be written)
.P
.SS Active UNIX domain Sockets
.SS "Proto" 
The protocol (usually unix) used by the socket.
.SS "RefCnt"
The reference count (i.e. attached processes via this socket).
.SS "Flags"
The flags displayed is SO_ACCEPTON (displayed as 
.BR ACC ),
SO_WAITDATA 
.RB ( W )
or SO_NOSPACE 
.RB ( N ). 
SO_ACCECPTON 
is used on unconnected sockets if their corresponding
processes are waiting for a connect request. The other flags are not
of normal interest.
.SS "Type"
There are several types of socket access:
.TP
.I
SOCK_DGRAM
The socket is used in Datagram (connectionless) mode.
.TP
.I
SOCK_STREAM
This is a stream (connection) socket.
.TP
.I
SOCK_RAW
The socket is used as a raw socket.
.TP
.I
SOCK_RDM
This one serves reliably-delivered messages.
.TP
.I
SOCK_SEQPACKET
This is a sequential packet socket.
.TP
.I
SOCK_PACKET
Raw interface access socket.
.TP
.I
UNKNOWN
Who ever knows what the future will bring us - just fill in here :-)
.PP
.SS "State"
This field will contain one of the following Keywords:
.TP
.I FREE
The socket is not allocated
.TP
.I LISTENING 
The socket is listening for a connection request.  Such
sockets are only included in the output if you specify the
.BR \-\-listening " (" \-l )
or
.BR \-\-all " (" \-a )
option.
.TP
.I CONNECTING
The socket is about to establish a connection.
.TP
.I CONNECTED
The socket is connected.
.TP
.I DISCONNECTING
The socket is disconnecting.
.TP
.I (empty)
The socket is not connected to another one.
.TP
.I UNKNOWN
This state should never happen.
.SS "PID/Program name"
Process ID (PID) and process name of the process that has the socket open. 
More info available in
.B "Active Internet connections"
section written above.
.SS "Path"
This is the path name as which the corresponding processes attached
to the socket.
.P
.SS Active IPX sockets
(this needs to be done by somebody who knows it)
.P
.SS Active NET/ROM sockets
(this needs to be done by somebody who knows it)
.P
.SS Active AX.25 sockets
(this needs to be done by somebody who knows it)
.PP
.SH NOTES
Starting with Linux release 2.2 
.B netstat -i 
does not show interface statistics for alias interfaces. To get per
alias interface counters you need to setup explicit rules using the
.BR ipchains(8) 
command.  

.SH FILES
.ta
.I /etc/services
-- The services translation file

.I /proc
-- Mount point for the proc filesystem, which gives access to kernel 
status information via the following files.

.I /proc/net/dev
-- device information

.I /proc/net/raw
-- raw socket information

.I /proc/net/tcp
-- TCP socket information

.I /proc/net/udp
-- UDP socket information

.I /proc/net/igmp
-- IGMP multicast information

.I /proc/net/unix
-- Unix domain socket information

.I /proc/net/ipx
-- IPX socket information

.I /proc/net/ax25
-- AX25 socket information

.I /proc/net/appletalk
-- DDP (appletalk) socket information

.I /proc/net/nr
-- NET/ROM socket information

.I /proc/net/route
-- IP routing information

.I /proc/net/ax25_route
-- AX25 routing information

.I /proc/net/ipx_route
-- IPX routing information

.I /proc/net/nr_nodes
-- NET/ROM nodelist

.I /proc/net/nr_neigh
-- NET/ROM neighbours

.I /proc/net/ip_masquerade
-- masqueraded connections

.I /proc/net/snmp
-- statistics
.fi
.P
.SH SEE ALSO
.BR route (8), 
.BR ifconfig (8), 
.BR ipchains (8),
.BR iptables (8),
.BR proc (5)
.P
.SH BUGS
Occasionally strange information may appear if a socket changes
as it is viewed. This is unlikely to occur.
.P
.SH AUTHORS
The netstat user interface was written by Fred Baumgarten
<dc6iq at insu1.etec.uni-karlsruhe.de> the man page basically
by Matt Welsh <mdw at tc.cornell.edu>. It was updated by
Alan Cox <Alan.Cox at linux.org> but could do with a bit more
work.  It was updated again by Tuan Hoang
<tqhoang at bigfoot.com>.
.br
The man page and the command included in the net-tools
package is totally rewritten by Bernd Eckenfels 
<ecki at linux.de>.

--- NEW FILE: plipconfig.8 ---
.TH PLIPCONFIG 8 "17 February 1995" "" ""
.SH NAME
plipconfig \- fine tune PLIP device parameters 
.SH SYNOPSIS
.B "plipconfig interface"
.br
.B "plipconfig interface [nibble NN] [trigger NN] [unit NN]"
.SH DESCRIPTION
.B Plipconfig
is used to (hopefully) improve PLIP performance by changing the default
timing parameters used by the PLIP protocol. Results are dependent on
the parallel port hardware, cable, and the CPU speed of each machine
on each end of the PLIP link.
.LP
If the single 
.B interface
argument is given,
.B plipconfig
displays the status of the given interface
only.  Otherwise, it will try to set the options.
.SH OPTIONS
.TP
.B "nibble NN"
Sets the nibble wait value in microseconds. Default is 3000.
.TP
.B "trigger NN"
Sets the trigger wait value in microseconds. Default is 500.
.LP
PLIP speed can in some cases be improved by lowering the default values.
Values which are too low may cause excess use of CPU, poor interrupt 
response time resulting in serial ports dropping characters, or in dropping
of PLIP packets. Changing the plip MTU can also affect PLIP speed.
.SH NOTE
If you get no response it is far more likely the irq is wrong and needs
setting with ifconfig. The few cases where the default parameters will
be too fast are those using very long cables. Something you should
never do as the parallel port is not specified or designed for driving
long cable runs.
.SH SEE ALSO
.I ifconfig(8)
.SH BUGS
Non.
.SH AUTHOR
John Paul Morrison, <jmorriso at bogomips.ee.ubc.ca>, <ve7jpm at ve7jpm.ampr.org>


--- NEW FILE: ypdomainname.1 ---
.so man1/hostname.1