doc: Consolidate NetRestrict format docmentation
[openafs.git] / doc / man-pages / pod5 / NetRestrict.pod
index 8d343ec..471b025 100644 (file)
@@ -7,9 +7,16 @@ NetRestrict - Defines interfaces not to register with AFS servers
 There are two F<NetRestrict> files, one for an AFS client and one for an
 AFS File Server or database server.  The AFS client F<NetRestrict> file
 specifies the IP addresses that the client should not register with the
-File Servers it connects to.  The server F<NetInfo> file specifies what
-interfaces should not be registered with AFS Database Servers or used to
-talk to other database servers.
+File Servers it connects to.  The server F<NetRestrict> file specifies
+what interfaces should not be registered with AFS Database Servers or used
+to talk to other database servers.
+
+=head2 FORMAT
+
+The F<NetRestrict> file is in ASCII format. One IP address appears on each
+line, in dotted decimal format. The order of the addresses is not
+significant. There is currently no mechanism to specify a range of
+addresses or a wildcard; each IP address must be listed individually.
 
 =head2 Client NetRestrict
 
@@ -26,13 +33,6 @@ Cache Manager then removes from the list any addresses that appear in the
 F<NetRestrict> file, if it exists. The Cache Manager records the resulting
 list in kernel memory.
 
-The F<NetRestrict> file is in ASCII format. One IP address appears on each
-line, in dotted decimal format. The order of the addresses is not
-significant. The value C<255> is a wildcard that represents all possible
-addresses in that field. For example, the value C<192.12.105.255>
-indicates that the Cache Manager does not register any of the addresses in
-the C<192.12.105> subnet.
-
 To display the addresses the Cache Manager is currently registering with
 File Servers, use the B<fs getclientaddrs> command.
 
@@ -67,18 +67,12 @@ the VLDB. The database server processes use a similar procedure when
 initializing, to determine which interfaces to use for communication with
 the peer processes on other database machines in the cell.
 
-The F<NetRestrict> file is in ASCII format. One IP address appears on each
-line, in dotted decimal format. The order of the addresses is not
-significant. The value C<255> is a wildcard that represents all possible
-addresses in that field. For example, the value C<192.12.105.255>
-indicates that the File Server or database server processes do not
-register or use any of the addresses in the C<192.12.105> subnet.
-
 To display the File Server interface addresses registered in the VLDB, use
 the B<vos listaddrs> command.
 
 =head1 SEE ALSO
 
+L<NetInfo(5)>,
 L<sysid(5)>,
 L<vldb.DB0(5)>,
 L<fileserver(8)>,