| 1 | .\" $Id: detach.1,v 1.9 1999-02-26 23:13:03 danw Exp $ |
|---|
| 2 | .\" |
|---|
| 3 | .\" Copyright 1997 by the Massachusetts Institute of Technology. |
|---|
| 4 | .\" |
|---|
| 5 | .\" Permission to use, copy, modify, and distribute this |
|---|
| 6 | .\" software and its documentation for any purpose and without |
|---|
| 7 | .\" fee is hereby granted, provided that the above copyright |
|---|
| 8 | .\" notice appear in all copies and that both that copyright |
|---|
| 9 | .\" notice and this permission notice appear in supporting |
|---|
| 10 | .\" documentation, and that the name of M.I.T. not be used in |
|---|
| 11 | .\" advertising or publicity pertaining to distribution of the |
|---|
| 12 | .\" software without specific, written prior permission. |
|---|
| 13 | .\" M.I.T. makes no representations about the suitability of |
|---|
| 14 | .\" this software for any purpose. It is provided "as is" |
|---|
| 15 | .\" without express or implied warranty. |
|---|
| 16 | .\" |
|---|
| 17 | .TH DETACH 1 |
|---|
| 18 | .SH NAME |
|---|
| 19 | detach \- detach a remote file system from your workstation |
|---|
| 20 | .SH SYNOPSIS |
|---|
| 21 | .nf |
|---|
| 22 | detach [-v | -q] [-y | -n] [-z | -h] [-x | -e] [-O] filesystem ... |
|---|
| 23 | detach [options] -m mountpoint ... |
|---|
| 24 | detach [options] [-t type] [-C] [-a | -H host ...] |
|---|
| 25 | .fi |
|---|
| 26 | .SH DESCRIPTION |
|---|
| 27 | .I detach |
|---|
| 28 | performs the appropriate filesystem-dependent operations to |
|---|
| 29 | disassociate a filesystem which was attached using |
|---|
| 30 | .BR attach (1) |
|---|
| 31 | from the workstation. |
|---|
| 32 | |
|---|
| 33 | The \fI-a\fP form is used to detach all attached filesystems from the |
|---|
| 34 | workstation. This is typically run when the workstation reactivates, |
|---|
| 35 | so as to flush all user mounted filesystems from the workstation. |
|---|
| 36 | |
|---|
| 37 | The following options are available in |
|---|
| 38 | .I detach\fP: |
|---|
| 39 | |
|---|
| 40 | .TP 8 |
|---|
| 41 | .I --verbose (-v) |
|---|
| 42 | Display verbose information about the success of the detach. This is |
|---|
| 43 | the default. |
|---|
| 44 | .TP 8 |
|---|
| 45 | .I --quiet (-q) |
|---|
| 46 | Don't display verbose information. |
|---|
| 47 | .TP 8 |
|---|
| 48 | .I --all (-a) |
|---|
| 49 | Attempt to detach all filesystems which had been attached using the |
|---|
| 50 | \fIattach\fP command. |
|---|
| 51 | .TP 8 |
|---|
| 52 | .I --unmap (-y) |
|---|
| 53 | Attempt to remove authentication for the user from the filesystem |
|---|
| 54 | server. The authentication will be removed even if the detach fails. |
|---|
| 55 | This is the default. |
|---|
| 56 | .TP 8 |
|---|
| 57 | .I --nomap (-n) |
|---|
| 58 | Do not attempt to remove authentication for the user from the |
|---|
| 59 | filesystem server. |
|---|
| 60 | .TP 8 |
|---|
| 61 | .I --zephyr (-z) |
|---|
| 62 | Remove \fIZephyr\fP subscription information about the server host. |
|---|
| 63 | This is the default. |
|---|
| 64 | .TP 8 |
|---|
| 65 | .I --nozephyr (-h) |
|---|
| 66 | Don't remove \fIZephyr\fP subscription information about the server host. |
|---|
| 67 | .TP 8 |
|---|
| 68 | .I --type \fIfilesystem-type\fP (-t \fIfilesystem-type\fP) |
|---|
| 69 | Used with the --all option to detach all filesystems of a particular |
|---|
| 70 | type. If not specified, the --all option will detach all filesystems. |
|---|
| 71 | .TP 8 |
|---|
| 72 | .I --explicit (-e) |
|---|
| 73 | Change the behavior of \fIdetach\fP such that the \fIfilesystem\fP is |
|---|
| 74 | now interpreted as \fIhost:directory\fP (in the case of NFS) or |
|---|
| 75 | \fIhost:pack\fP (in the case of RVD) instead of as a Hesiod name. |
|---|
| 76 | Type --type option can be used to specify the filesystem type. |
|---|
| 77 | .TP 8 |
|---|
| 78 | .I --noexplicit (-x) |
|---|
| 79 | Tell \fIdetach\fP to interpret the \fIfilesystem\fP as a Hesiod name. |
|---|
| 80 | This is the default. |
|---|
| 81 | .TP 8 |
|---|
| 82 | .I --mountpoint (-m) |
|---|
| 83 | Specify the locker to be detach by its mountpoint, instead of its |
|---|
| 84 | filesystem name. This can be used to detach a locker that was attached |
|---|
| 85 | in a non-standard location. |
|---|
| 86 | .TP 8 |
|---|
| 87 | .I --override (-O) |
|---|
| 88 | This option allows the trusted users to force a filesystem to be |
|---|
| 89 | detached, even if it was attached by another user or locked. |
|---|
| 90 | .TP 8 |
|---|
| 91 | .I --host \fIhost\fP (-H \fIhost\fP) |
|---|
| 92 | Requests detach to detach all remote filesystems whose fileserver |
|---|
| 93 | matches the specified host. |
|---|
| 94 | .TP 8 |
|---|
| 95 | .I --clean (-C) |
|---|
| 96 | This option indicates that the specified filesystems should be detached |
|---|
| 97 | if they are not wanted by anyone who is in \fI/etc/passwd\fP. |
|---|
| 98 | |
|---|
| 99 | .SH DIAGNOSTICS |
|---|
| 100 | If \fIdetach\fP is unable to initalize the locker library, it will |
|---|
| 101 | exist with status 1. If \fIdetach\fP encounters a problem detaching a |
|---|
| 102 | locker, it will continue trying to detach any remaining lockers on the |
|---|
| 103 | command line, but eventually exit with status 2. (This does not apply |
|---|
| 104 | to \fIdetach -a\fP or \fIdetach -H\fP, which will exit with status 0 |
|---|
| 105 | if they successfully detach any locker.) |
|---|
| 106 | |
|---|
| 107 | .SH FILES |
|---|
| 108 | /etc/athena/attach.conf |
|---|
| 109 | .br |
|---|
| 110 | /var/athena/attachtab/ |
|---|
| 111 | |
|---|
| 112 | .SH "SEE ALSO" |
|---|
| 113 | attach(1), attach.conf(5) |
|---|
| 114 | |
|---|
| 115 | .SH AUTHOR |
|---|
| 116 | Dan Winship, MIT Information Systems |
|---|
| 117 | .PP |
|---|
| 118 | based on the original detach by |
|---|
| 119 | .br |
|---|
| 120 | Robert French, Project Athena |
|---|
| 121 | .PP |
|---|
| 122 | Copyright 1988, 1998 Massachusetts Institute of Technology |
|---|
