8d343ec15d5b11ea3c03e84b4baa1118e4b88bd0
[openafs.git] / doc / man-pages / pod5 / NetRestrict.pod
1 =head1 NAME
2
3 NetRestrict - Defines interfaces not to register with AFS servers
4
5 =head1 DESCRIPTION
6
7 There are two F<NetRestrict> files, one for an AFS client and one for an
8 AFS File Server or database server.  The AFS client F<NetRestrict> file
9 specifies the IP addresses that the client should not register with the
10 File Servers it connects to.  The server F<NetInfo> file specifies what
11 interfaces should not be registered with AFS Database Servers or used to
12 talk to other database servers.
13
14 =head2 Client NetRestrict
15
16 The F<NetRestrict> file, if present in a client machine's F</usr/vice/etc>
17 directory, defines the IP addresses of the interfaces that the local Cache
18 Manager does not register with a File Server when first establishing a
19 connection to it. For an explanation of how the File Server uses the
20 registered interfaces, see L<NetInfo(5)>.
21
22 As it initializes, the Cache Manager constructs a list of interfaces to
23 register, from the F</usr/vice/etc/NetInfo> file if it exists, or from the
24 list of interfaces configured with the operating system otherwise.  The
25 Cache Manager then removes from the list any addresses that appear in the
26 F<NetRestrict> file, if it exists. The Cache Manager records the resulting
27 list in kernel memory.
28
29 The F<NetRestrict> file is in ASCII format. One IP address appears on each
30 line, in dotted decimal format. The order of the addresses is not
31 significant. The value C<255> is a wildcard that represents all possible
32 addresses in that field. For example, the value C<192.12.105.255>
33 indicates that the Cache Manager does not register any of the addresses in
34 the C<192.12.105> subnet.
35
36 To display the addresses the Cache Manager is currently registering with
37 File Servers, use the B<fs getclientaddrs> command.
38
39 =head2 Server NetRestrict
40
41 The F<NetRestrict> file, if present in the F</usr/afs/local> directory,
42 defines the following:
43
44 =over 4
45
46 =item *
47
48 On a file server machine, the local interfaces that the File Server
49 (B<fileserver> process) does not register in the Volume Location Database
50 (VLDB) at initialization time.
51
52 =item *
53
54 On a database server machine, the local interfaces that the Ubik
55 synchronization library does not use when communicating with the database
56 server processes running on other database server machines.
57
58 =back
59
60 As it initializes, the File Server constructs a list of interfaces to
61 register, from the F</usr/afs/local/NetInfo> file if it exists, or from
62 the list of interfaces configured with the operating system otherwise. The
63 File Server then removes from the list any addresses that appear in the
64 F<NetRestrict> file, if it exists. The File Server records the resulting
65 list in the F</usr/afs/local/sysid> file and registers the interfaces in
66 the VLDB. The database server processes use a similar procedure when
67 initializing, to determine which interfaces to use for communication with
68 the peer processes on other database machines in the cell.
69
70 The F<NetRestrict> file is in ASCII format. One IP address appears on each
71 line, in dotted decimal format. The order of the addresses is not
72 significant. The value C<255> is a wildcard that represents all possible
73 addresses in that field. For example, the value C<192.12.105.255>
74 indicates that the File Server or database server processes do not
75 register or use any of the addresses in the C<192.12.105> subnet.
76
77 To display the File Server interface addresses registered in the VLDB, use
78 the B<vos listaddrs> command.
79
80 =head1 SEE ALSO
81
82 L<sysid(5)>,
83 L<vldb.DB0(5)>,
84 L<fileserver(8)>,
85 L<fs_getclientaddrs(1)>
86 L<vos_listaddrs(1)>
87
88 =head1 COPYRIGHT
89
90 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
91
92 This documentation is covered by the IBM Public License Version 1.0.  It was
93 converted from HTML to POD by software written by Chas Williams and Russ
94 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.