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>
39 #define UNMOUNT_CIFS_VERSION_MAJOR "0"
40 #define UNMOUNT_CIFS_VERSION_MINOR "5"
42 #ifndef UNMOUNT_CIFS_VENDOR_SUFFIX
43 #define UNMOUNT_CIFS_VENDOR_SUFFIX ""
47 #define MNT_DETACH 0x02
51 #define MNT_EXPIRE 0x04
55 #define MOUNTED_LOCK "/etc/mtab~"
58 #define MOUNTED_TEMP "/etc/mtab.tmp"
61 #define CIFS_IOC_CHECKUMOUNT _IO(0xCF, 2)
62 #define CIFS_MAGIC_NUMBER 0xFF534D42 /* the first four bytes of SMB PDU */
64 static struct option longopts
[] = {
65 { "all", 0, NULL
, 'a' },
66 { "help",0, NULL
, 'h' },
67 { "read-only", 0, NULL
, 'r' },
68 { "ro", 0, NULL
, 'r' },
69 { "verbose", 0, NULL
, 'v' },
70 { "version", 0, NULL
, 'V' },
71 { "expire", 0, NULL
, 'e' },
72 { "force", 0, 0, 'f' },
73 { "lazy", 0, 0, 'l' },
74 { "no-mtab", 0, 0, 'n' },
81 static void umount_cifs_usage(void)
83 printf("\nUsage: %s <remotetarget> <dir>\n", thisprogram
);
84 printf("\nUnmount the specified directory\n");
85 printf("\nLess commonly used options:");
86 printf("\n\t-r\tIf mount fails, retry with readonly remount.");
87 printf("\n\t-n\tDo not write to mtab.");
88 printf("\n\t-f\tAttempt a forced unmount, even if the fs is busy.");
89 printf("\n\t-l\tAttempt lazy unmount, Unmount now, cleanup later.");
90 printf("\n\t-v\tEnable verbose mode (may be useful for debugging).");
91 printf("\n\t-h\tDisplay this help.");
92 printf("\n\nOptions are described in more detail in the manual page");
93 printf("\n\tman 8 umount.cifs\n");
94 printf("\nTo display the version number of the cifs umount utility:");
95 printf("\n\t%s -V\n",thisprogram
);
96 printf("\nInvoking the umount utility on cifs mounts, can execute");
97 printf(" /sbin/umount.cifs (if present and umount -i is not specified.\n");
100 static int umount_check_perm(char * dir
)
105 /* allow root to unmount, no matter what */
109 /* presumably can not chdir into the target as we do on mount */
110 fileid
= open(dir
, O_RDONLY
| O_DIRECTORY
| O_NOFOLLOW
, 0);
113 printf("error opening mountpoint %d %s",errno
,strerror(errno
));
117 rc
= ioctl(fileid
, CIFS_IOC_CHECKUMOUNT
, NULL
);
120 printf("ioctl returned %d with errno %d %s\n",rc
,errno
,strerror(errno
));
123 printf("user unmounting via %s is an optional feature of",thisprogram
);
124 printf(" the cifs filesystem driver (cifs.ko)");
125 printf("\n\tand requires cifs.ko version 1.32 or later\n");
127 printf("user unmount of %s failed with %d %s\n",dir
,errno
,strerror(errno
));
137 rc
= mknod(MOUNTED_LOCK
, 0600, 0);
139 printf("\ngetting lock file %s failed with %s\n",MOUNTED_LOCK
,
146 void unlock_mtab(void)
148 unlink(MOUNTED_LOCK
);
151 int remove_from_mtab(char * mountpoint
)
157 struct mntent
* mount_entry
;
159 /* Do we need to check if it is a symlink to e.g. /proc/mounts
160 in which case we probably do not want to update it? */
162 /* Do we first need to check if it is writable? */
165 printf("Mount table locked\n");
170 printf("attempting to remove from mtab\n");
172 org_fd
= setmntent(MOUNTED
, "r");
175 printf("Can not open %s\n",MOUNTED
);
180 new_fd
= setmntent(MOUNTED_TEMP
,"w");
182 printf("Can not open temp file %s", MOUNTED_TEMP
);
188 /* BB fix so we only remove the last entry that matches BB */
190 while((mount_entry
= getmntent(org_fd
)) != NULL
) {
191 if(strcmp(mount_entry
->mnt_dir
, mountpoint
) == 0) {
196 printf("%d matching entries in mount table\n", num_matches
);
198 /* Is there a better way to seek back to the first entry in mtab? */
200 org_fd
= setmntent(MOUNTED
, "r");
203 printf("Can not open %s\n",MOUNTED
);
208 while((mount_entry
= getmntent(org_fd
)) != NULL
) {
209 if(strcmp(mount_entry
->mnt_dir
, mountpoint
) != 0) {
210 addmntent(new_fd
, mount_entry
);
212 if(num_matches
!= 1) {
213 addmntent(new_fd
, mount_entry
);
215 } else if(verboseflg
)
216 printf("entry not copied (ie entry is removed)\n");
221 printf("done updating tmp file\n");
222 rc
= fchmod (fileno (new_fd
), S_IRUSR
|S_IWUSR
|S_IRGRP
|S_IROTH
);
224 printf("error %s changing mode of %s\n", strerror(errno
),
229 rc
= rename(MOUNTED_TEMP
, MOUNTED
);
232 printf("failure %s renaming %s to %s\n",strerror(errno
),
233 MOUNTED_TEMP
, MOUNTED
);
243 int main(int argc
, char ** argv
)
249 int retry_remount
= 0;
250 struct statfs statbuf
;
254 thisprogram
= argv
[0];
265 if(thisprogram
== NULL
)
266 thisprogram
= "umount.cifs";
268 /* add sharename in opts string as unc= parm */
270 while ((c
= getopt_long (argc
, argv
, "afhilnrvV",
271 longopts
, NULL
)) != -1) {
273 /* No code to do the following option yet */
288 flags
|= MNT_DETACH
; /* lazy unmount */
291 flags
|= MNT_EXPIRE
; /* gradually timeout */
300 printf ("umount.cifs version: %s.%s%s\n",
301 UNMOUNT_CIFS_VERSION_MAJOR
,
302 UNMOUNT_CIFS_VERSION_MINOR
,
303 UNMOUNT_CIFS_VENDOR_SUFFIX
);
306 printf("unknown unmount option %c\n",c
);
312 /* move past the umount options */
316 mountpoint
= argv
[0];
318 if((argc
< 1) || (argv
[0] == NULL
)) {
319 printf("\nMissing name of unmount directory\n");
325 printf("optind %d unmount dir %s\n",optind
, mountpoint
);
327 /* check if running effectively root */
329 printf("Trying to unmount when %s not installed suid\n",thisprogram
);
331 printf("euid = %d\n",geteuid());
335 /* fixup path if needed */
337 /* make sure that this is a cifs filesystem */
338 rc
= statfs(mountpoint
, &statbuf
);
340 if(rc
|| (statbuf
.f_type
!= CIFS_MAGIC_NUMBER
)) {
341 printf("This utility only unmounts cifs filesystems.\n");
345 /* check if our uid was the one who mounted */
346 rc
= umount_check_perm(mountpoint
);
348 printf("Not permitted to unmount\n");
352 if(umount2(mountpoint
, flags
)) {
353 /* remember to kill daemon on error */
356 printf("unmount failed but no error number set\n");
359 printf("unmount error %d = %s\n",errno
,strerror(errno
));
361 printf("Refer to the umount.cifs(8) manual page (man 8 umount.cifs)\n");
365 printf("umount2 succeeded\n");
367 remove_from_mtab(mountpoint
);