source: trunk/athena/bin/attach/attachtab.5 @ 9809

Revision 9809, 2.0 KB checked in by ghudson, 27 years ago (diff)
Move attachtab and the attach temporary files to /var/athena. Note that the attach temporary files were previously incorrectly documented as being /tmp/attach.<filesystem> instead of /tmp/attach_<filesystem>.
Line 
1.TH ATTACHTAB 5  "July 16 1990"
2.SH NAME
3attachtab \- attached filesystem table
4.SH DESCRIPTION
5Attach maintains an printable text database of all successful attaches
6in the \fIattachtab\fR.  It uses this file to determine the current status
7of a filesystem (attached, being attached, being detached) and to
8retrieve information about it.  The following information is stored in
9/var/athena/attachtab:
10
11A version number
12.br
13An explicit flag
14.br
15The status of the filesystem (attached, being attached, or being detached).
16.br
17The type of the filesystem (e.g., NFS, RVD, etc.).
18.br
19The \fIHesiod\fR name of the filesystem (or the explicit name when
20-explicit is specified).
21.br
22The name of the server on which the filesystem is located, if the
23filesystem is on a remote host.
24.br
25The server's pathname or RVD locker name for the filesystem.
26.br
27The internet address of the server.
28.br
29The number of directories that had to be created to make the
30mount point.
31.br
32The mount point pathname.
33.br
34The RVD driver number (if the filesystem is of type RVD).
35.br
36The userid of the user who attached the filesystem
37.br
38A flags field.  If the lowest bit is set, the the filesystem was
39mounted with the nosuid option set.
40.br
41The mode (r or w) of the filesystem.
42
43\fIAttach\fR and \fIdetach\fR also communicate via temporary files in
44/var/athena.  These files are used to determine whether or not the
45status field of /var/athena/attachtab is accurate.  For example, if an
46\fIattach\fR is aborted for some reason, /var/athena/attachtab may
47still indicate that the filesystem is in the process of being
48attached.  These files are named /var/athena/attach_\fIfilesystem\fR,
49and are deleted as soon as they are no longer needed.  An advisory
50lock is kept by the active process on the file to indicate that a
51process really is operating on the filesystem.
52
53.SH FILES
54The location of attachtab can be dynamically configured in
55/etc/athena/attach.conf; by default it is located in
56/var/athena/attachtab.  It is also commonly placed in
57/etc/athena/attachtab.
58.SH SEE ALSO
59attach(1), attach.conf(5)
Note: See TracBrowser for help on using the repository browser.