|-file <output file>||Specifies the full pathname of a file to which to write the preference ranks. If the specified file already exists, the command overwrites its contents. If the pathname is invalid, the command fails. If this argument is not provided, the preference ranks appear on the standard output stream.|
|-numeric||Displays the IP addresses of file server machine interfaces or VL Server machines, rather than their hostnames. If this argument is not provided, the fs command interpreter has the IP addresses translated to hostnames such as fs1.abc.com.|
|-vlservers||Displays preference ranks for VL Server machines rather than file server machine interfaces.|
|-help||Prints the online help for this command. All other valid options are ignored.|
The output consists of a separate line for each file server machine interface or VL Server machine, pairing the machines hostname or IP address with its rank. The Cache Manager stores IP addresses in its kernel list of ranks, but the command by default identifies interfaces by hostname, by calling a translation routine that refers to either the cells name service (such as the Domain Name Server) or the local host table. If an IP address appears in the output, it is because the translation attempt failed. To bypass the translation step and display IP addresses rather than hostnames, include the -numeric flag. This can significantly speed the production of output.
By default, the command writes to the standard output stream. Use the -file argument to write the output to a file instead.
The following example displays the local Cache Managers preference ranks for file server machines. The local machine belongs to the AFS cell named abc.com, and in this example the ranks of file server machines in its local cell are lower than the ranks of file server machines from the foreign cell, def.com. It is not possible to translate the IP addresses of two machines on the 138.255 network.
% fs getserverprefs fs2.abc.com 20007 fs3.abc.com 30002 fs1.abc.com 20011 fs4.abc.com 30010 server1.def.com 40002 220.127.116.11 40000 server6.def.com 40012 18.104.22.168 40005
The following example shows hows the output displays IP addresses when the -numeric flag is included, and illustrates how network proximity determines default ranks (as described on the fs setserverprefs reference page). The local machine has IP address 22.214.171.124, and the two file server machines on its subnetwork have ranks of 20,007 and 20,011. The two file server machines on a different subnetwork of the local machines network have higher ranks, 30,002 and 30,010, whereas the ranks of the remaining machines range from 40,000 to 40,012 because they are in a completely different network.
% fs getserverprefs -numeric 126.96.36.199 20007 188.8.131.52 30002 184.108.40.206 20011 220.127.116.11 30010 18.104.22.168 40002 22.214.171.124 40000 126.96.36.199 40012 188.8.131.52 40005
The example shows how the -vlservers flag displays preference ranks for VL Server machines:
% fs getserverprefs -vlservers fs2.abc.com 10052 fs3.abc.com 10113 fs1.abc.com 10005
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.