2 Unmount utility program for Linux CIFS VFS (virtual filesystem) client
3 Copyright (C) 2005 Steve French (sfrench@us.ibm.com)
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
27 #include <sys/types.h>
28 #include <sys/mount.h>
29 #include <sys/ioctl.h>
38 #define UNMOUNT_CIFS_VERSION_MAJOR "0"
39 #define UNMOUNT_CIFS_VERSION_MINOR "5"
41 #ifndef UNMOUNT_CIFS_VENDOR_SUFFIX
42 #define UNMOUNT_CIFS_VENDOR_SUFFIX ""
46 #define MNT_DETACH 0x02
50 #define MNT_EXPIRE 0x04
54 #define MOUNTED_LOCK "/etc/mtab~"
57 #define MOUNTED_TEMP "/etc/mtab.tmp"
60 #define CIFS_IOC_CHECKUMOUNT _IO(0xCF, 2)
61 #define CIFS_MAGIC_NUMBER 0xFF534D42 /* the first four bytes of SMB PDU */
63 static struct option longopts
[] = {
64 { "all", 0, NULL
, 'a' },
65 { "help",0, NULL
, 'h' },
66 { "read-only", 0, NULL
, 'r' },
67 { "ro", 0, NULL
, 'r' },
68 { "verbose", 0, NULL
, 'v' },
69 { "version", 0, NULL
, 'V' },
70 { "expire", 0, NULL
, 'e' },
71 { "force", 0, 0, 'f' },
72 { "lazy", 0, 0, 'l' },
73 { "no-mtab", 0, 0, 'n' },
80 static void umount_cifs_usage(void)
82 printf("\nUsage: %s <remotetarget> <dir>\n", thisprogram
);
83 printf("\nUnmount the specified directory\n");
84 printf("\nLess commonly used options:");
85 printf("\n\t-r\tIf mount fails, retry with readonly remount.");
86 printf("\n\t-n\tDo not write to mtab.");
87 printf("\n\t-f\tAttempt a forced unmount, even if the fs is busy.");
88 printf("\n\t-l\tAttempt lazy unmount, Unmount now, cleanup later.");
89 printf("\n\t-v\tEnable verbose mode (may be useful for debugging).");
90 printf("\n\t-h\tDisplay this help.");
91 printf("\n\nOptions are described in more detail in the manual page");
92 printf("\n\tman 8 umount.cifs\n");
93 printf("\nTo display the version number of the cifs umount utility:");
94 printf("\n\t%s -V\n",thisprogram
);
95 printf("\nInvoking the umount utility on cifs mounts, can execute");
96 printf(" /sbin/umount.cifs (if present and umount -i is not specified.\n");
99 static int umount_check_perm(char * dir
)
104 /* allow root to unmount, no matter what */
108 /* presumably can not chdir into the target as we do on mount */
109 fileid
= open(dir
, O_RDONLY
| O_DIRECTORY
| O_NOFOLLOW
, 0);
112 printf("error opening mountpoint %d %s",errno
,strerror(errno
));
116 rc
= ioctl(fileid
, CIFS_IOC_CHECKUMOUNT
, NULL
);
119 printf("ioctl returned %d with errno %d %s\n",rc
,errno
,strerror(errno
));
122 printf("user unmounting via %s is an optional feature of",thisprogram
);
123 printf(" the cifs filesystem driver (cifs.ko)");
124 printf("\n\tand requires cifs.ko version 1.32 or later\n");
126 printf("user unmount of %s failed with %d %s\n",dir
,errno
,strerror(errno
));
136 rc
= mknod(MOUNTED_LOCK
, 0600, 0);
138 printf("\ngetting lock file %s failed with %s\n",MOUNTED_LOCK
,
145 void unlock_mtab(void)
147 unlink(MOUNTED_LOCK
);
150 int remove_from_mtab(char * mountpoint
)
156 struct mntent
* mount_entry
;
158 /* Do we need to check if it is a symlink to e.g. /proc/mounts
159 in which case we probably do not want to update it? */
161 /* Do we first need to check if it is writable? */
164 printf("Mount table locked\n");
169 printf("attempting to remove from mtab\n");
171 org_fd
= setmntent(MOUNTED
, "r");
174 printf("Can not open %s\n",MOUNTED
);
179 new_fd
= setmntent(MOUNTED_TEMP
,"w");
181 printf("Can not open temp file %s", MOUNTED_TEMP
);
187 /* BB fix so we only remove the last entry that matches BB */
189 while((mount_entry
= getmntent(org_fd
)) != NULL
) {
190 if(strcmp(mount_entry
->mnt_dir
, mountpoint
) == 0) {
195 printf("%d matching entries in mount table\n", num_matches
);
197 /* Is there a better way to seek back to the first entry in mtab? */
199 org_fd
= setmntent(MOUNTED
, "r");
202 printf("Can not open %s\n",MOUNTED
);
207 while((mount_entry
= getmntent(org_fd
)) != NULL
) {
208 if(strcmp(mount_entry
->mnt_dir
, mountpoint
) != 0) {
209 addmntent(new_fd
, mount_entry
);
211 if(num_matches
!= 1) {
212 addmntent(new_fd
, mount_entry
);
214 } else if(verboseflg
)
215 printf("entry not copied (ie entry is removed)\n");
220 printf("done updating tmp file\n");
221 rc
= fchmod (fileno (new_fd
), S_IRUSR
|S_IWUSR
|S_IRGRP
|S_IROTH
);
223 printf("error %s changing mode of %s\n", strerror(errno
),
228 rc
= rename(MOUNTED_TEMP
, MOUNTED
);
231 printf("failure %s renaming %s to %s\n",strerror(errno
),
232 MOUNTED_TEMP
, MOUNTED
);
242 int main(int argc
, char ** argv
)
248 int retry_remount
= 0;
249 struct statfs statbuf
;
253 thisprogram
= argv
[0];
264 if(thisprogram
== NULL
)
265 thisprogram
= "umount.cifs";
267 /* add sharename in opts string as unc= parm */
269 while ((c
= getopt_long (argc
, argv
, "afhilnrvV",
270 longopts
, NULL
)) != -1) {
272 /* No code to do the following option yet */
287 flags
|= MNT_DETACH
; /* lazy unmount */
290 flags
|= MNT_EXPIRE
; /* gradually timeout */
299 printf ("umount.cifs version: %s.%s%s\n",
300 UNMOUNT_CIFS_VERSION_MAJOR
,
301 UNMOUNT_CIFS_VERSION_MINOR
,
302 UNMOUNT_CIFS_VENDOR_SUFFIX
);
305 printf("unknown unmount option %c\n",c
);
311 /* move past the umount options */
315 mountpoint
= argv
[0];
317 if((argc
< 1) || (argv
[0] == NULL
)) {
318 printf("\nMissing name of unmount directory\n");
324 printf("optind %d unmount dir %s\n",optind
, mountpoint
);
326 /* check if running effectively root */
328 printf("Trying to unmount when %s not installed suid\n",thisprogram
);
330 printf("euid = %d\n",geteuid());
334 /* fixup path if needed */
336 /* make sure that this is a cifs filesystem */
337 rc
= statfs(mountpoint
, &statbuf
);
339 if(rc
|| (statbuf
.f_type
!= CIFS_MAGIC_NUMBER
)) {
340 printf("This utility only unmounts cifs filesystems.\n");
344 /* check if our uid was the one who mounted */
345 rc
= umount_check_perm(mountpoint
);
347 printf("Not permitted to unmount\n");
351 if(umount2(mountpoint
, flags
)) {
352 /* remember to kill daemon on error */
355 printf("unmount failed but no error number set\n");
358 printf("unmount error %d = %s\n",errno
,strerror(errno
));
360 printf("Refer to the umount.cifs(8) manual page (man 8 umount.cifs)\n");
364 printf("umount2 succeeded\n");
366 remove_from_mtab(mountpoint
);