viced-multiple-ports-per-client-20051208
[openafs.git] / doc / man-pages / pod / fs_rmmount.pod
1 =head1 NAME
2
3 fs rmmount - Removes a mount point
4
5 =head1 SYNOPSIS
6
7 fs rmmount B<-dir> I<directory> [I<directory> ...]  [B<-help>]
8
9 fs rm B<-d> I<directory> [I<directory> ...]  [B<-h>]
10
11 =head1 DESCRIPTION
12
13 The C<fs rmmount> command removes the mount point named by the B<-dir>
14 argument from the file system. The corresponding volume remains on its
15 host partition or partitions, but is inaccessible if there are no
16 other mount points for it.
17
18 =head1 OPTIONS
19
20 =over 4
21
22 =item B<-dir> I<directory> [I<directory> ...]
23
24 Names the mount point to delete from the file system. The last
25 element in the pathname must be an actual name, not a shorthand
26 notation such as "dot" (.) or "dot dot" (..).
27
28 Specify the read/write path to the directory, to avoid the
29 failure that results from attempting to delete a mount point
30 from a read-only volume. By convention, the read/write path is
31 indicated by placing a period before the cell name at the
32 pathname's second level (for example, B</afs/.abc.com>). For
33 further discussion of the concept of read/write and read-only
34 paths through the filespace, see the L<fs_mkmount(1)> reference page.
35
36 =item B<-help>
37
38 Prints the online help for this command. All other valid
39 options are ignored.
40
41 =back
42
43 =head1 EXAMPLES
44
45 The following command removes the mount points B<jones> and B<terry> from
46 the current working directory (the B</afs/abc.com/usr> directory).
47
48     fs rmmount jones terry
49
50 =head1 PRIVILEGE REQUIRED
51
52 The issuer must have the B<d> (B<delete>) permission on the ACL of the
53 directory that houses each mount point.
54
55 =head1 COPYRIGHT
56
57 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
58
59 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
60 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
61 Stanford Linear Accelerator Center, a department of Stanford University.
62
63 =head1 SEE ALSO
64
65 L<fs_lsmount(1)>,
66 L<fs_mkmount(1)>
67
68 =cut