Annotation of 43BSDReno/share/doc/smm/01.setup/common/5.t, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980, 1986, 1988 Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted
        !             5: .\" provided that the above copyright notice and this paragraph are
        !             6: .\" duplicated in all such forms and that any documentation,
        !             7: .\" advertising materials, and other materials related to such
        !             8: .\" distribution and use acknowledge that the software was developed
        !             9: .\" by the University of California, Berkeley.  The name of the
        !            10: .\" University may not be used to endorse or promote products derived
        !            11: .\" from this software without specific prior written permission.
        !            12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
        !            13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
        !            14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            15: .\"
        !            16: .\"    @(#)5.t 6.4 (Berkeley) 6/22/90
        !            17: .\"
        !            18: .ds lq ``
        !            19: .ds rq ''
        !            20: .ds LH "Installing/Operating \*(4B
        !            21: .ds RH Network setup
        !            22: .ds CF \*(DY
        !            23: .LP
        !            24: .nr H1 5
        !            25: .nr H2 0
        !            26: .bp
        !            27: .LG
        !            28: .B
        !            29: .ce
        !            30: 5. NETWORK SETUP
        !            31: .sp 2
        !            32: .R
        !            33: .NL
        !            34: .ds B3 4.3BSD
        !            35: .PP
        !            36: \*(B3 provides support for the DARPA standard Internet
        !            37: protocols IP, ICMP, TCP, and UDP.  These protocols may be used
        !            38: on top of a variety of hardware devices ranging from the
        !            39: IMP's (PSN's) used in the ARPANET to local area network controllers
        !            40: for the Ethernet.  Network services are split between the
        !            41: kernel (communication protocols) and user programs (user
        !            42: services such as TELNET and FTP).  This section describes
        !            43: how to configure your system to use the Internet networking support.
        !            44: \*(B3 also supports the Xerox Network Systems (NS) protocols.
        !            45: IDP and SPP are implemented in the kernel,
        !            46: and other protocols such as Courier run at the user level.
        !            47: \*(B3 provides some support for the ISO OSI protocols CLNP
        !            48: TP4, and ESIS.  User level process
        !            49: complete the application protocols such as X.400 and X.500.
        !            50: .NH 2
        !            51: System configuration
        !            52: .PP
        !            53: To configure the kernel to include the Internet communication
        !            54: protocols, define the INET option.
        !            55: Xerox NS support is enabled with the NS option.
        !            56: ISO OSI support is enabled with the ISO option.
        !            57: In either case, include the pseudo-devices
        !            58: ``pty'', and ``loop'' in your machine's configuration
        !            59: file.  
        !            60: The ``pty'' pseudo-device forces the pseudo terminal device driver
        !            61: to be configured into the system, see \fIpty\fP\|(4), while
        !            62: the ``loop'' pseudo-device forces inclusion of the software loopback
        !            63: interface driver.
        !            64: The loop driver is used in network testing
        !            65: and also by the error logging system.
        !            66: .PP
        !            67: If you are planning to use the Internet network facilities on a 10Mb/s
        !            68: Ethernet, the pseudo-device ``ether'' should also be included
        !            69: in the configuration; this forces inclusion of the Address Resolution
        !            70: Protocol module used in mapping between 48-bit Ethernet
        !            71: and 32-bit Internet addresses.
        !            72: Also, if you have an IMP connection,
        !            73: you will need to include the pseudo-device ``imp.''
        !            74: .PP
        !            75: Before configuring the appropriate networking hardware, you should
        !            76: consult the manual pages in section 4 of the Programmer's Manual.
        !            77: The following table lists the devices for which software support
        !            78: exists.
        !            79: .DS
        !            80: .TS
        !            81: l l.
        !            82: Device name    Manufacturer and product
        !            83: _
        !            84: .if \n(Vx \{\
        !            85: acc    ACC LH/DH interface to IMP
        !            86: css    DEC IMP-11A interface to IMP
        !            87: ddn    ACC ACP625 DDN Standard mode X.25 interface to IMP
        !            88: dmc    DEC DMC-11 (also works with DMR-11)
        !            89: de     DEC DEUNA 10Mb/s Ethernet
        !            90: ec     3Com 10Mb/s Ethernet
        !            91: en     Xerox 3Mb/s prototype Ethernet (not a product)
        !            92: ex     Excelan 204 10Mb/s Ethernet
        !            93: hdh    ACC IF-11/HDH IMP interface
        !            94: hy     NSC Hyperchannel, w/ DR-11B and PI-13 interfaces
        !            95: il     Interlan 1010 and 10101A 10Mb/s Ethernet interfaces
        !            96: ix     Interlan NP100 10Mb/s Ethernet interface
        !            97: pcl    DEC PCL-11
        !            98: vv     Proteon 10Mb/s and 80Mb/s proNET ring network (V2LNI)
        !            99: .\}
        !           100: .if \n(Th \{\
        !           101: ace    ACC 10Mb/s Ethernet
        !           102: enp    CMC 10Mb/s Ethernet
        !           103: .\}
        !           104: .TE
        !           105: .DE
        !           106: .PP
        !           107: All network interface drivers including the loopback interface,
        !           108: require that their host address(es) be defined at boot time.
        !           109: This is done with
        !           110: .IR ifconfig (8C)
        !           111: commands included in the \fI/etc/netstart\fP file.
        !           112: Interfaces that are able to dynamically deduce the host
        !           113: part of an address may check that the host part of the address is correct.
        !           114: The manual page for each network interface
        !           115: describes the method used to establish a host's address.
        !           116: .IR Ifconfig (8C)
        !           117: can also be used to set options for the interface at boot time.
        !           118: Options are set independently for each interface, and
        !           119: apply to all packets sent using that interface.
        !           120: These options include disabling the use of the Address Resolution Protocol;
        !           121: this may be useful if a network is shared with hosts running software
        !           122: that does not yet provide this function.
        !           123: Alternatively, translations for such hosts may be set in advance
        !           124: or ``published'' by a \*(B3 host by use of the
        !           125: .IR arp (8C)
        !           126: command.
        !           127: Note that the use of trailer link-level is now negotiated between \*(B3 hosts
        !           128: using ARP,
        !           129: and it is thus no longer necessary to disable the use of trailers
        !           130: with \fIifconfig\fP.
        !           131: .PP
        !           132: The OSI equivalent to ARP is ESIS (End System to Intermediate System Routeing
        !           133: Protocol); running this protocol is mandatory, however one can manually add
        !           134: translations for machines that do not participate by use of the
        !           135: .IR route (8C)
        !           136: command.
        !           137: Additional information is provided in the manual page describing
        !           138: .IR ESIS (4).
        !           139: .PP
        !           140: To use the pseudo terminals just configured, device
        !           141: entries must be created in the /dev directory.  To create 32
        !           142: pseudo terminals (plenty, unless you have a heavy network load)
        !           143: execute the following commands.
        !           144: .DS
        !           145: \fB#\fP \fIcd /dev\fP
        !           146: \fB#\fP \fIMAKEDEV pty0 pty1\fP
        !           147: .DE
        !           148: More pseudo terminals may be made by specifying \fIpty2\fP, \fIpty3\fP,
        !           149: etc.  The kernel normally includes support for 32 pseudo terminals
        !           150: unless the configuration file specifies a different number.
        !           151: Each pseudo terminal really consists of two files in /dev:
        !           152: a master and a slave.  The master pseudo terminal file is named
        !           153: /dev/ptyp?, while the slave side is /dev/ttyp?.  Pseudo terminals
        !           154: are also used by several programs not related to the network.
        !           155: In addition to creating the pseudo terminals,
        !           156: be sure to install them in the
        !           157: .I /etc/ttys
        !           158: file (with a `none' in the second column so no
        !           159: .I getty
        !           160: is started).
        !           161: .NH 2
        !           162: Local subnets
        !           163: .PP
        !           164: In \*(B3 the DARPA Internet support
        !           165: includes the notion of ``subnets''.  This is a mechanism
        !           166: by which multiple local networks may appears as a single Internet
        !           167: network to off-site hosts.  Subnetworks are useful because
        !           168: they allow a site to hide their local topology, requiring only a single
        !           169: route in external gateways;
        !           170: it also means that local network numbers may be locally administered.
        !           171: The standard describing this change in Internet addressing is RFC-950.
        !           172: .PP
        !           173: To set up local subnets one must first decide how the available
        !           174: address space (the Internet ``host part'' of the 32-bit address)
        !           175: is to be partitioned.
        !           176: Sites with a class A network
        !           177: number have a 24-bit host address space with which to work, sites with a
        !           178: class B network number have a 16-bit host address space, while sites with
        !           179: a class C network number have an 8-bit host address space.*
        !           180: .FS
        !           181: * If you are unfamiliar with the Internet addressing structure, consult
        !           182: ``Address Mappings'', Internet RFC-796, J. Postel; available from
        !           183: the Internet Network Information Center at SRI.
        !           184: .FE
        !           185: To define local subnets you must steal some bits
        !           186: from the local host address space for use in extending the network
        !           187: portion of the Internet address.  This reinterpretation of Internet
        !           188: addresses is done only for local networks; i.e. it is not visible
        !           189: to hosts off-site.  For example, if your site has a class B network
        !           190: number, hosts on this network have an Internet address that contains
        !           191: the network number, 16 bits, and the host number, another
        !           192: 16 bits.  To define 254 local subnets, each
        !           193: possessing at most 255 hosts, 8 bits may be taken from the local part.
        !           194: (The use of subnets 0 and all-1's, 255 in this example, is discouraged
        !           195: to avoid confusion about broadcast addresses.)
        !           196: These new network
        !           197: numbers are then constructed by concatenating the original 16-bit network
        !           198: number with the extra 8 bits containing the local subnet number.
        !           199: .PP
        !           200: The existence of local subnets is communicated to the system at the time a
        !           201: network interface is configured with the
        !           202: .I netmask
        !           203: option to the
        !           204: .I ifconfig
        !           205: program.  A ``network mask'' is specified to define the
        !           206: portion of the Internet address that is to be considered the network part
        !           207: for that network.
        !           208: This mask normally contains the bits corresponding to the standard
        !           209: network part as well as the portion of the local part
        !           210: that has been assigned to subnets.
        !           211: If no mask is specified when the address is set,
        !           212: it will be set according to the class of the network.
        !           213: For example, at Berkeley (class B network 128.32) 8 bits
        !           214: of the local part have been reserved for defining subnets;
        !           215: consequently the /etc/netstart file contains lines of the form
        !           216: .DS
        !           217: /etc/ifconfig en0 netmask 0xffffff00 128.32.1.7
        !           218: .DE
        !           219: This specifies that for interface ``en0'', the upper 24 bits of
        !           220: the Internet address should be used in calculating network numbers
        !           221: (netmask 0xffffff00), and the interface's Internet address is
        !           222: ``128.32.1.7'' (host 7 on network 128.32.1).  Hosts \fIm\fP on
        !           223: sub-network \fIn\fP of this network would then have addresses of
        !           224: the form ``128.32.\fIn\fP.\fIm\fP'';  for example, host
        !           225: 99 on network 129 would have an address ``128.32.129.99''.
        !           226: For hosts with multiple interfaces, the network mask should
        !           227: be set for each interface,
        !           228: although in practice only the mask of the first interface on each network
        !           229: is actually used.
        !           230: .NH 2
        !           231: Internet broadcast addresses
        !           232: .PP
        !           233: The address defined as the broadcast address for Internet networks
        !           234: according to RFC-919 is the address with a host part of all 1's.
        !           235: The address used by 4.2BSD was the address with a host part of 0.
        !           236: \*(B3 uses the standard broadcast address (all 1's) by default,
        !           237: but allows the broadcast address to be set (with \fIifconfig\fP)
        !           238: for each interface.
        !           239: This allows networks consisting of both 4.2BSD and \*(B3 hosts
        !           240: to coexist while the upgrade process proceeds.
        !           241: In the presence of subnets, the broadcast address uses the subnet field
        !           242: as for normal host addresses, with the remaining host part set to 1's
        !           243: (or 0's, on a network that has not yet been converted).
        !           244: \*(B3 hosts recognize and accept packets
        !           245: sent to the logical-network broadcast address as well as those sent
        !           246: to the subnet broadcast address, and when using an all-1's broadcast,
        !           247: also recognize and receive packets sent to host 0 as a broadcast.
        !           248: .NH 2
        !           249: Routing
        !           250: .PP
        !           251: If your environment allows access to networks not directly
        !           252: attached to your host you will need to set up routing information
        !           253: to allow packets to be properly routed.  Two schemes are
        !           254: supported by the system.  The first scheme
        !           255: employs the routing table management daemon \fI/etc/routed\fP
        !           256: to maintain the system routing tables.  The routing daemon
        !           257: uses a variant of the Xerox Routing Information Protocol
        !           258: to maintain up to date routing tables in a cluster of local
        !           259: area networks.  By using the \fI/etc/gateways\fP
        !           260: file created by
        !           261: .IR htable (8),
        !           262: the routing daemon can also be used to initialize static routes
        !           263: to distant networks (see the next section for further discussion).
        !           264: When the routing daemon is started up
        !           265: (usually from \fI/etc/rc\fP) it reads \fI/etc/gateways\fP if it exists
        !           266: and installs those routes defined there, then broadcasts on each local network
        !           267: to which the host is attached to find other instances of the routing
        !           268: daemon.  If any responses are received, the routing daemons
        !           269: cooperate in maintaining a globally consistent view of routing
        !           270: in the local environment.  This view can be extended to include
        !           271: remote sites also running the routing daemon by setting up suitable
        !           272: entries in \fI/etc/gateways\fP; consult
        !           273: .IR routed (8C)
        !           274: for a more thorough discussion.
        !           275: .PP
        !           276: The second approach is to define a default or wildcard
        !           277: route to a smart
        !           278: gateway and depend on the gateway to provide ICMP routing
        !           279: redirect information to dynamically create a routing data
        !           280: base.  This is done by adding an entry of the form
        !           281: .DS
        !           282: /etc/route add default \fIsmart-gateway\fP 1
        !           283: .DE
        !           284: to \fI/etc/netstart\fP; see
        !           285: .IR route (8C)
        !           286: for more information.  The default route
        !           287: will be used by the system as a ``last resort''
        !           288: in routing packets to their destination.  Assuming the gateway
        !           289: to which packets are directed is able to generate the proper
        !           290: routing redirect messages, the system will then add routing
        !           291: table entries based on the information supplied.  This approach
        !           292: has certain advantages over the routing daemon, but is
        !           293: unsuitable in an environment where there are only bridges (i.e.
        !           294: pseudo gateways that, for instance, do not generate routing
        !           295: redirect messages).  Further, if the
        !           296: smart gateway goes down there is no alternative, save manual
        !           297: alteration of the routing table entry, to maintaining service.
        !           298: .PP
        !           299: The system always listens, and processes, routing redirect
        !           300: information, so it is possible to combine both of the above
        !           301: facilities.  For example, the routing table management process
        !           302: might be used to maintain up to date information about routes
        !           303: to geographically local networks, while employing the wildcard
        !           304: routing techniques for ``distant'' networks.  The
        !           305: .IR netstat (1)
        !           306: program may be used to display routing table contents as well
        !           307: as various routing oriented statistics.  For example,
        !           308: .DS
        !           309: \fB#\fP \fInetstat \-r\fP
        !           310: .DE
        !           311: will display the contents of the routing tables, while
        !           312: .DS
        !           313: \fB#\fP \fInetstat \-r \-s\fP
        !           314: .DE
        !           315: will show the number of routing table entries dynamically
        !           316: created as a result of routing redirect messages, etc.
        !           317: .NH 2
        !           318: Use of \*(B3 machines as gateways
        !           319: .PP
        !           320: Several changes have been made in \*(B3 in the area of gateway support
        !           321: (or packet forwarding, if one prefers).
        !           322: A new configuration option, GATEWAY, is used when configuring
        !           323: a machine to be used as a gateway.
        !           324: This option increases the size of the routing hash tables in the kernel.
        !           325: Unless configured with that option,
        !           326: hosts with only a single non-loopback interface never attempt
        !           327: to forward packets or to respond with ICMP error messages to misdirected
        !           328: packets.
        !           329: This change reduces the problems that may occur when different hosts
        !           330: on a network disagree as to the network number or broadcast address.
        !           331: Another change is that \*(B3 machines that forward packets back through
        !           332: the same interface on which they arrived
        !           333: will send ICMP redirects to the source host if it is on the same network.
        !           334: This improves the interaction of \*(B3 gateways with hosts that configure
        !           335: their routes via default gateways and redirects.
        !           336: The generation of redirects may be disabled with the configuration option
        !           337: IPSENDREDIRECTS=0 in environments where it may cause difficulties.
        !           338: .PP
        !           339: Local area routing within a group of interconnected Ethernets
        !           340: and other such networks may be handled by
        !           341: .IR routed (8C).
        !           342: Gateways between the Arpanet or Milnet and one or more local networks
        !           343: require an additional routing protocol, the Exterior Gateway Protocol (EGP),
        !           344: to inform the core gateways of their presence
        !           345: and to acquire routing information from the core.
        !           346: An EGP implementation for \*(B3 is available
        !           347: by anonymous ftp from ucbarpa.berkeley.edu.  If necessary, contact the
        !           348: Berkeley Computer Systems Research Group for assistance.
        !           349: .NH 2
        !           350: Network data bases
        !           351: .PP
        !           352: Several data files are used by the network library routines
        !           353: and server programs.  Most of these files are host independent
        !           354: and updated only rarely.
        !           355: .DS
        !           356: .TS
        !           357: l l l.
        !           358: File   Manual reference        Use
        !           359: _
        !           360: /etc/hosts     \fIhosts\fP\|(5)        host names
        !           361: /etc/networks  \fInetworks\fP\|(5)     network names
        !           362: /etc/services  \fIservices\fP\|(5)     list of known services
        !           363: /etc/protocols \fIprotocols\fP\|(5)    protocol names
        !           364: /etc/hosts.equiv       \fIrshd\fP\|(8C)        list of ``trusted'' hosts
        !           365: /etc/netstart  \fIrc\fP\|(8)   command script for initializing network
        !           366: /etc/rc        \fIrc\fP\|(8)   command script for starting standard servers
        !           367: /etc/rc.local  \fIrc\fP\|(8)   command script for starting local servers
        !           368: /etc/ftpusers  \fIftpd\fP\|(8C)        list of ``unwelcome'' ftp users
        !           369: /etc/hosts.lpd \fIlpd\fP\|(8C) list of hosts allowed to access printers
        !           370: /etc/inetd.conf        \fIinetd\fP\|(8)        list of servers started by \fIinetd\fP
        !           371: .TE
        !           372: .DE
        !           373: The files distributed are set up for ARPANET or other Internet hosts.
        !           374: Local networks and hosts should be added to describe the local
        !           375: configuration; the Berkeley entries may serve as examples
        !           376: (see also the section on on /etc/hosts).
        !           377: Network numbers will have to be chosen for each Ethernet.
        !           378: For sites connected to the Internet,
        !           379: the normal channels should be used for allocation of network
        !           380: numbers (contact [email protected]).
        !           381: For other sites,
        !           382: these could be chosen more or less arbitrarily,
        !           383: but it is generally better to request official numbers
        !           384: to avoid conversion if a connection to the Internet (or others on the Internet)
        !           385: is ever established.
        !           386: .NH 3
        !           387: Network servers
        !           388: .PP
        !           389: Most network servers are automatically started up at boot time
        !           390: by the command file /etc/rc
        !           391: or by the Internet daemon (see below).
        !           392: These include the following:
        !           393: .DS
        !           394: .TS
        !           395: l l l.
        !           396: Program        Server  Started by
        !           397: _
        !           398: /etc/syslogd   error logging server    /etc/rc
        !           399: /etc/named     Internet name server    /etc/rc
        !           400: /etc/routed    routing table management daemon /etc/rc
        !           401: /etc/rwhod     system status daemon    /etc/rc
        !           402: /etc/timed     time synchronization daemon     /etc/rc.local
        !           403: /usr/lib/sendmail      SMTP server     /etc/rc.local
        !           404: /etc/rshd      shell server    inetd
        !           405: /etc/rexecd    exec server     inetd
        !           406: /etc/rlogind   login server    inetd
        !           407: /etc/telnetd   TELNET server   inetd
        !           408: /etc/ftpd      FTP server      inetd
        !           409: /etc/fingerd   Finger server   inetd
        !           410: /etc/tftpd     TFTP server     inetd
        !           411: .TE
        !           412: .DE
        !           413: Consult the manual pages and accompanying documentation (particularly
        !           414: for named and sendmail) for details about their operation.
        !           415: .PP
        !           416: The use of \fIrouted\fP and \fIrwhod\fP is controlled by shell
        !           417: variables set in /etc/netstart.
        !           418: By default, \fIrouted\fP is used, but \fIrwhod\fP is not;
        !           419: they are enabled by setting the variables \fIroutedflags\fP
        !           420: and \fIrwhod\fP to strings other than ``NO.''
        !           421: The value of \fIroutedflags\fP is used to provide host-specific options
        !           422: to \fIrouted\fP.
        !           423: For example,
        !           424: .DS
        !           425: routedflags=-q
        !           426: rwhod=NO
        !           427: .DE
        !           428: would run \fIrouted -q\fP and would not run \fIrwhod\fP.
        !           429: .PP
        !           430: To have other network servers started as well,
        !           431: commands of the following sort should be placed in the site-dependent
        !           432: file \fI/etc/rc.local\fP.
        !           433: .DS
        !           434: if [ -f /etc/timed ]; then
        !           435:        /etc/timed & echo -n ' timed'                   >/dev/console
        !           436: f\&i
        !           437: .DE
        !           438: .NH 3
        !           439: Internet daemon
        !           440: .PP
        !           441: In \*(B3 most of the servers for user-visible services are started up by a
        !           442: ``super server'', the Internet daemon.  The Internet
        !           443: daemon, \fI/etc/inetd\fP, acts as a master server for
        !           444: programs specified in its configuration file, \fI/etc/inetd.conf\fP,
        !           445: listening for service requests for these servers, and starting
        !           446: up the appropriate program whenever a request is received.
        !           447: The configuration file contains lines containing a service
        !           448: name (as found in \fI/etc/services\fP), the type of socket the
        !           449: server expects (e.g. stream or dgram), the protocol to be
        !           450: used with the socket (as found in \fI/etc/protocols\fP), whether
        !           451: to wait for each server to complete before starting up another,
        !           452: the user name as which the server should run, the server
        !           453: program's name, and at most five arguments to pass to the
        !           454: server program.
        !           455: Some trivial services are implemented internally in \fIinetd\fP,
        !           456: and their servers are listed as ``internal.''
        !           457: For example, an entry for the file
        !           458: transfer protocol server would appear as
        !           459: .DS
        !           460: ftp    stream  tcp     nowait  root    /etc/ftpd       ftpd
        !           461: .DE
        !           462: Consult
        !           463: .IR inetd (8C)
        !           464: for more detail on the format of the configuration file
        !           465: and the operation of the Internet daemon.
        !           466: .NH 3
        !           467: Regenerating /etc/hosts and /etc/networks
        !           468: .PP
        !           469: When using the host address routines that use the Internet name server,
        !           470: the file \fI/etc/hosts\fP is only used for setting interface addresses
        !           471: and at other times that the server is not running,
        !           472: and therefore it need only contain addresses for local hosts.
        !           473: There is no equivalent service for network names yet.
        !           474: The full host and network name data bases are normally derived from
        !           475: a file retrieved from the Internet Network Information Center at
        !           476: SRI.
        !           477: To do this you should use the program /etc/gettable
        !           478: to retrieve the NIC host data base, and the program
        !           479: .IR htable (8)
        !           480: to convert it to the format used by the libraries.
        !           481: You should change to the directory where you maintain your local
        !           482: additions to the host table and execute the following commands.
        !           483: .DS
        !           484: \fB#\fP \fI/etc/gettable sri-nic.arpa\fP
        !           485: \fBConnection to sri-nic.arpa opened.\fP
        !           486: \fBHost table received.\fP
        !           487: \fBConnection to sri-nic.arpa closed.\fP
        !           488: \fB#\fP \fI/etc/htable hosts.txt\fP
        !           489: \fBWarning, no localgateways file.\fP
        !           490: \fB#\fP
        !           491: .DE
        !           492: The \fIhtable\fP program generates three files
        !           493: in the local directory: \fIhosts\fP, \fInetworks\fP and \fIgateways\fP.
        !           494: If a file ``localhosts'' is present in the working directory its
        !           495: contents are first copied to the output file.  Similarly, a
        !           496: ``localnetworks'' file may be prepended to the output created
        !           497: by \fIhtable\fP,
        !           498: and `localgateways'' will be prepended to \fIgateways\fP.
        !           499: It is usually wise to run \fIdiff\fP\|(1) on
        !           500: the new host and network data bases before installing them in /etc.
        !           501: If you are using the host table for host name and address
        !           502: mapping, you should run \fImkhosts\fP\|(8) after installing
        !           503: \fI/etc/hosts\fP.
        !           504: If you are using the name server for the host name and address mapping,
        !           505: you only need to install \fInetworks\fP and a small copy of \fIhosts\fP
        !           506: describing your local machines.  The full host table in this case might
        !           507: be placed somewhere else for reference by users.
        !           508: The gateways file may be installed in \fI/etc/gateways\fP if you use
        !           509: .IR routed (8C)
        !           510: for local routing and wish to have static external routes installed
        !           511: when \fIrouted\fP is started.
        !           512: This procedure is essentially obsolete, however, except for individual hosts
        !           513: that are on the Arpanet or Milnet and do not forward packets from a local
        !           514: network.
        !           515: Other situations require the use of an EGP server.
        !           516: .PP
        !           517: If you are connected to the DARPA Internet, it is highly recommended that
        !           518: you use the name server for your host name and address mapping, as this
        !           519: provides access to a much larger set of hosts than are provided in the
        !           520: host table.  Many large organizations on the network currently have
        !           521: only a small percentage of their hosts listed in the host table retrieved
        !           522: from NIC.
        !           523: .NH 3
        !           524: /etc/hosts.equiv
        !           525: .PP
        !           526: The remote login and shell servers use an
        !           527: authentication scheme based on trusted hosts.  The \fIhosts.equiv\fP
        !           528: file contains a list of hosts that are considered trusted
        !           529: and, under a single administrative control.  When a user
        !           530: contacts a remote login or shell server requesting service,
        !           531: the client process passes the user's name and the official
        !           532: name of the host on which the client is located.  In the simple
        !           533: case, if the host's name is located in \fIhosts.equiv\fP and
        !           534: the user has an account on the server's machine, then service
        !           535: is rendered (i.e. the user is allowed to log in, or the command
        !           536: is executed).  Users may expand this ``equivalence'' of
        !           537: machines by installing a \fI.rhosts\fP file in their login directory.
        !           538: The root login is handled specially, bypassing the \fIhosts.equiv\fP
        !           539: file, and using only the \fI/.rhosts\fP file.
        !           540: .PP
        !           541: Thus, to create a class of equivalent machines, the \fIhosts.equiv\fP
        !           542: file should contain the \fIofficial\fP names for those machines.
        !           543: If you are running the name server, you may omit the domain part
        !           544: of the host name for machines in your local domain.
        !           545: For example, four machines on our local
        !           546: network are considered trusted, so the \fIhosts.equiv\fP file is
        !           547: of the form:
        !           548: .DS
        !           549: ucbarpa
        !           550: okeeffe
        !           551: monet
        !           552: ucbvax
        !           553: .DE
        !           554: .NH 3
        !           555: /etc/ftpusers
        !           556: .PP
        !           557: The FTP server included in the system provides support for an
        !           558: anonymous FTP account.  Because of the inherent security problems
        !           559: with such a facility you should read this section carefully if
        !           560: you consider providing such a service.
        !           561: .PP
        !           562: An anonymous account is enabled by creating a user \fIftp\fP.
        !           563: When a client uses the anonymous account a \fIchroot\fP\|(2)
        !           564: system call is performed by the server to restrict the client
        !           565: from moving outside that part of the file system where the
        !           566: user ftp home directory is located.  Because a \fIchroot\fP call
        !           567: is used, certain programs and files used by the server 
        !           568: process must be placed in the ftp home directory. 
        !           569: Further, one must be
        !           570: sure that all directories and executable images are unwritable.
        !           571: The following directory setup is recommended.  The
        !           572: use of the \fIawk\fP commands to copy the /etc/passwd and /etc/group
        !           573: files are \fBSTRONGLY\fP recommended.
        !           574: .DS
        !           575: \fB#\fP \fIcd ~ftp\fP
        !           576: \fB#\fP \fIchmod 555 .; chown ftp .; chgrp ftp .\fP
        !           577: \fB#\fP \fImkdir bin etc pub\fP
        !           578: \fB#\fP \fIchown root bin etc\fP
        !           579: \fB#\fP \fIchmod 555 bin etc\fP
        !           580: \fB#\fP \fIchown ftp pub\fP
        !           581: \fB#\fP \fIchmod 777 pub\fP
        !           582: \fB#\fP \fIcd bin\fP
        !           583: \fB#\fP \fIcp /bin/sh /bin/ls .\fP
        !           584: \fB#\fP \fIchmod 111 sh ls\fP
        !           585: \fB#\fP \fIcd ../etc\fP
        !           586: \fB#\fP \fIawk -F: '{$2="*";print$1":"$2":"$3":"$4":"$5":"$6":"}' < /etc/passwd > passwd\fP
        !           587: \fB#\fP \fIawk -F: '{$2="*";print$1":"$2":"}' < /etc/group > group\fP
        !           588: \fB#\fP \fIchmod 444 passwd group\fP
        !           589: .DE
        !           590: When local users wish to place files in the anonymous
        !           591: area, they must be placed in a subdirectory.  In the
        !           592: setup here, the directory \fI~ftp/pub\fP is used.
        !           593: .PP
        !           594: Aside from the problems of directory modes and such,
        !           595: the ftp server may provide a loophole for interlopers
        !           596: if certain user accounts are allowed.
        !           597: The file \fI/etc/ftpusers\fP is checked on each connection.
        !           598: If the requested user name is located in the file, the
        !           599: request for service is denied.  This file normally has
        !           600: the following names on our systems.
        !           601: .DS
        !           602: uucp
        !           603: root
        !           604: .DE
        !           605: Accounts without passwords need not be listed in this file as the ftp
        !           606: server will refuse service to these users.
        !           607: Accounts with nonstandard shells (any not listed in /etc/shells)
        !           608: will also be denied access via ftp.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.