windows-issues-20050925
[openafs.git] / doc / html / AdminReference / auarf024.htm
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
2 <HTML><HEAD>
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records  ========================================== -->
5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
10 </HEAD><BODY>
11 <!-- (C) IBM Corporation 2000. All Rights Reserved    --> 
12 <BODY bgcolor="ffffff"> 
13 <!-- End Header Records  ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Administration Reference</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf023.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf025.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17 <P>
18 <H2><A NAME="HDRCLI_NETINFO" HREF="auarf002.htm#ToC_22">NetInfo (client version)</A></H2>
19 <P><STRONG>Purpose</STRONG>
20 <A NAME="IDX3942"></A>
21 <A NAME="IDX3943"></A>
22 <A NAME="IDX3944"></A>
23 <A NAME="IDX3945"></A>
24 <A NAME="IDX3946"></A>
25 <A NAME="IDX3947"></A>
26 <P>Defines client machine interfaces to register with the File Server
27 <P><STRONG>Description</STRONG>
28 <P>The <B>NetInfo</B> file lists the IP addresses of one or more of the
29 local machine's network interfaces. If it exists in the
30 <B>/usr/vice/etc</B> directory when the Cache Manager initializes, the
31 Cache Manager uses its contents as the basis for a list of local
32 interfaces. Otherwise, the Cache Manager uses the list of interfaces
33 configured with the operating system. It then removes from the list any
34 addresses that appear in the <B>/usr/vice/etc/NetRestrict</B> file, if it
35 exists. The Cache Manager records the resulting list in kernel
36 memory. The first time it establishes a connection to a File Server, it
37 registers the list with the File Server.
38 <P>The File Server uses the addresses when it initiates a remote procedure
39 call (RPC) to the Cache Manager (as opposed to responding to an RPC sent by
40 the Cache Manager). There are two common circumstances in which the
41 File Server initiates RPCs: when it breaks callbacks and when it pings
42 the client machine to verify that the Cache Manager is still
43 accessible.
44 <P>The <B>NetInfo</B> file is in ASCII format. One of the
45 machine's IP addresses appears on each line, in dotted decimal
46 format. The File Server initially uses the address that appears first
47 in the list. The order of the remaining addresses is not
48 significant: if an RPC to the first interface fails, the File Server
49 simultaneously sends RPCs to all of the other interfaces in the list.
50 Whichever interface replies first is the one to which the File Server then
51 sends pings and RPCs to break callbacks.
52 <P>To prohibit the Cache Manager absolutely from using one or more addresses,
53 list them in the <B>NetRestrict</B> file. To display the addresses
54 the Cache Manager is currently registering with File Servers, use the <B>fs
55 getclientaddrs</B> command. To replace the current list of interfaces
56 with a new one between reboots of the client machine, use the <B>fs
57 setclientaddrs</B> command.
58 <P><STRONG>Related Information</STRONG>
59 <P><A HREF="auarf026.htm#HDRCLI_NETRESTRICT">NetRestrict (client version)</A>
60 <P><A HREF="auarf145.htm#HDRFS_GETCLIENTADDRS">fs getclientaddrs</A>
61 <P><A HREF="auarf160.htm#HDRFS_SETCLIENTADDRS">fs setclientaddrs</A>
62 <P>
63 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf023.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf025.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
64 <!-- Begin Footer Records  ========================================== -->
65 <P><HR><B> 
66 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
67 </B> 
68 <!-- End Footer Records  ============================================ -->
69 <A NAME="Bot_Of_Page"></A>
70 </BODY></HTML>