2 # Copyright (c) 1996, Carnegie Mellon University
5 # See CMU_copyright.pm for use and distribution information
7 package OpenAFS::config;
11 OpenAFS::config - AFStools configuration
19 This module contains various AFStools configuration variables which are used
20 by the other AFStools modules. These describe how AFStools should act in a
21 particular installation, and are mostly pretty mundane. All of the defaults
22 here are pretty reasonable, so you shouldn't have to change anything unless
23 your site is particularly exotic.
25 Note that this file only describes how a particular B<installation> of AFStools
26 should act, not how it should act upon a particular B<cell>. Since the cell
27 AFStools is running in is not necessarily the same as the cell on which it
28 is acting, most configuration that is really per-cell should be located in a
31 This module should only be used by other parts of AFStools. As such, the
32 variables described here are not normally visible to user programs, and this
33 file is mostly of interest to administrators who are installing AFStools.
39 use OpenAFS::CMU_copyright;
46 @EXPORT = qw($def_ConfDir
52 # The following configuration variables are defined here. Mention them
53 # all an extra time, to suppress annoying warnings. Doesn't perl have
54 # a way of doing this???
56 @x = ($def_ConfDir, @CmdList, @CmdPath);
58 =item $def_ConfDir - Default configuration directory
60 This is the default AFS configuration directory, where files like ThisCell,
61 CellServDB, and so on are found. If the AFStools parameter I<confdir> is
62 set, it will generally be searched before this directory. Normally, this
63 should be set to F</usr/vice/etc> and not changed, as that path is hardwired
64 into AFS. However, it might be necessary to modify this if your site uses
65 an exotic locally-compiled version of AFS.
69 $def_ConfDir = "$openafsdirpath->{'viceetcdir'}";
70 #$def_ConfDir = "/usr/vice/etc";
73 =item @CmdList - List of AFS commands
75 This is a list of AFS commands that the AFStools package might want to invoke
76 using B<OpenAFS::wrapper::wrapper>. Don't remove anything from this list if you
77 know what's good for you. It's OK to add things, though, if you think you
78 might use the wrapper features for something.
82 @CmdList = ('fs', 'pts', 'vos', 'bos', 'kas', 'krbkas', 'sys');
85 =item @CmdPath - Path to search for AFS commands
87 This is the list of directories where B<OpenAFS::wrapper::wrapper> will look for
88 AFS commands. For AFStools to work properly, every command listed in
89 I<@OpenAFS::config::CmdList> must appear in one of these directories. The default
90 should be sufficient for most sites; we deal with Transarc's reccommendations
91 as well as common practice. Note that on machines for which /usr/afs/bin
92 exists (typically, AFS fileservers), that directory is first. This is probably
97 @CmdPath = (split(/:/, $ENV{PATH}),
98 "$openafsdirpath->{'afssrvbindir'}", # For servers
99 '/usr/local/bin', # Many sites put AFS in /usr/local
101 '/usr/afsws/bin', # For people who use Transarc's
102 '/usr/afsws/etc'); # silly reccommendations
104 =item $err_table_dir - Error table directory
106 This is the location of error tables used by the errcode and errstr
107 routines in OpenAFS::errtrans. Each file in this directory should be a
108 com_err error table (in source form), and should be named the same
109 as the com_err error package contained within.
113 $err_table_dir = '/usr/local/lib/errtbl';
121 The CMUCS AFStools, including this module are
122 Copyright (c) 1996, Carnegie Mellon University. All rights reserved.
123 For use and redistribution information, see CMUCS/CMU_copyright.pm