2 * Copyright 2008 Red Hat, Inc. All rights reserved.
3 * Copyright 2008 Ian Kent <raven@themaw.net>
5 * This file is part of the Linux kernel and is made available under
6 * the terms of the GNU General Public License, version 2, or at your
7 * option, any later version, incorporated herein by reference.
10 #include <linux/module.h>
11 #include <linux/vmalloc.h>
12 #include <linux/miscdevice.h>
13 #include <linux/init.h>
14 #include <linux/wait.h>
15 #include <linux/namei.h>
16 #include <linux/fcntl.h>
17 #include <linux/file.h>
18 #include <linux/fdtable.h>
19 #include <linux/sched.h>
20 #include <linux/compat.h>
21 #include <linux/syscalls.h>
22 #include <linux/smp_lock.h>
23 #include <linux/magic.h>
24 #include <linux/dcache.h>
25 #include <linux/uaccess.h>
30 * This module implements an interface for routing autofs ioctl control
31 * commands via a miscellaneous device file.
33 * The alternate interface is needed because we need to be able open
34 * an ioctl file descriptor on an autofs mount that may be covered by
35 * another mount. This situation arises when starting automount(8)
36 * or other user space daemon which uses direct mounts or offset
37 * mounts (used for autofs lazy mount/umount of nested mount trees),
38 * which have been left busy at at service shutdown.
41 #define AUTOFS_DEV_IOCTL_SIZE sizeof(struct autofs_dev_ioctl)
43 typedef int (*ioctl_fn
)(struct file
*, struct autofs_sb_info
*,
44 struct autofs_dev_ioctl
*);
46 static int check_name(const char *name
)
48 if (!strchr(name
, '/'))
54 * Check a string doesn't overrun the chunk of
55 * memory we copied from user land.
57 static int invalid_str(char *str
, void *end
)
59 while ((void *) str
<= end
)
66 * Check that the user compiled against correct version of autofs
69 * As well as checking the version compatibility this always copies
70 * the kernel interface version out.
72 static int check_dev_ioctl_version(int cmd
, struct autofs_dev_ioctl
*param
)
76 if ((AUTOFS_DEV_IOCTL_VERSION_MAJOR
!= param
->ver_major
) ||
77 (AUTOFS_DEV_IOCTL_VERSION_MINOR
< param
->ver_minor
)) {
78 AUTOFS_WARN("ioctl control interface version mismatch: "
79 "kernel(%u.%u), user(%u.%u), cmd(%d)",
80 AUTOFS_DEV_IOCTL_VERSION_MAJOR
,
81 AUTOFS_DEV_IOCTL_VERSION_MINOR
,
82 param
->ver_major
, param
->ver_minor
, cmd
);
86 /* Fill in the kernel version. */
87 param
->ver_major
= AUTOFS_DEV_IOCTL_VERSION_MAJOR
;
88 param
->ver_minor
= AUTOFS_DEV_IOCTL_VERSION_MINOR
;
94 * Copy parameter control struct, including a possible path allocated
95 * at the end of the struct.
97 static struct autofs_dev_ioctl
*copy_dev_ioctl(struct autofs_dev_ioctl __user
*in
)
99 struct autofs_dev_ioctl tmp
, *ads
;
101 if (copy_from_user(&tmp
, in
, sizeof(tmp
)))
102 return ERR_PTR(-EFAULT
);
104 if (tmp
.size
< sizeof(tmp
))
105 return ERR_PTR(-EINVAL
);
107 ads
= kmalloc(tmp
.size
, GFP_KERNEL
);
109 return ERR_PTR(-ENOMEM
);
111 if (copy_from_user(ads
, in
, tmp
.size
)) {
113 return ERR_PTR(-EFAULT
);
119 static inline void free_dev_ioctl(struct autofs_dev_ioctl
*param
)
126 * Check sanity of parameter control fields and if a path is present
127 * check that it has a "/" and is terminated.
129 static int validate_dev_ioctl(int cmd
, struct autofs_dev_ioctl
*param
)
133 err
= check_dev_ioctl_version(cmd
, param
);
135 AUTOFS_WARN("invalid device control module version "
136 "supplied for cmd(0x%08x)", cmd
);
140 if (param
->size
> sizeof(*param
)) {
141 err
= check_name(param
->path
);
143 AUTOFS_WARN("invalid path supplied for cmd(0x%08x)",
148 err
= invalid_str(param
->path
,
149 (void *) ((size_t) param
+ param
->size
));
151 AUTOFS_WARN("invalid path supplied for cmd(0x%08x)",
163 * Get the autofs super block info struct from the file opened on
164 * the autofs mount point.
166 static struct autofs_sb_info
*autofs_dev_ioctl_sbi(struct file
*f
)
168 struct autofs_sb_info
*sbi
= NULL
;
172 inode
= f
->f_path
.dentry
->d_inode
;
173 sbi
= autofs4_sbi(inode
->i_sb
);
178 /* Return autofs module protocol version */
179 static int autofs_dev_ioctl_protover(struct file
*fp
,
180 struct autofs_sb_info
*sbi
,
181 struct autofs_dev_ioctl
*param
)
183 param
->arg1
= sbi
->version
;
187 /* Return autofs module protocol sub version */
188 static int autofs_dev_ioctl_protosubver(struct file
*fp
,
189 struct autofs_sb_info
*sbi
,
190 struct autofs_dev_ioctl
*param
)
192 param
->arg1
= sbi
->sub_version
;
197 * Walk down the mount stack looking for an autofs mount that
198 * has the requested device number (aka. new_encode_dev(sb->s_dev).
200 static int autofs_dev_ioctl_find_super(struct nameidata
*nd
, dev_t devno
)
202 struct dentry
*dentry
;
204 struct super_block
*sb
;
210 /* Lookup the dentry name at the base of our mount point */
211 dentry
= d_lookup(nd
->path
.dentry
, &nd
->last
);
215 dput(nd
->path
.dentry
);
216 nd
->path
.dentry
= dentry
;
218 /* And follow the mount stack looking for our autofs mount */
219 while (follow_down(&nd
->path
.mnt
, &nd
->path
.dentry
)) {
220 inode
= nd
->path
.dentry
->d_inode
;
225 s_dev
= new_encode_dev(sb
->s_dev
);
226 if (devno
== s_dev
) {
227 if (sb
->s_magic
== AUTOFS_SUPER_MAGIC
) {
238 * Walk down the mount stack looking for an autofs mount that
239 * has the requested mount type (ie. indirect, direct or offset).
241 static int autofs_dev_ioctl_find_sbi_type(struct nameidata
*nd
, unsigned int type
)
243 struct dentry
*dentry
;
244 struct autofs_info
*ino
;
249 /* Lookup the dentry name at the base of our mount point */
250 dentry
= d_lookup(nd
->path
.dentry
, &nd
->last
);
254 dput(nd
->path
.dentry
);
255 nd
->path
.dentry
= dentry
;
257 /* And follow the mount stack looking for our autofs mount */
258 while (follow_down(&nd
->path
.mnt
, &nd
->path
.dentry
)) {
259 ino
= autofs4_dentry_ino(nd
->path
.dentry
);
260 if (ino
&& ino
->sbi
->type
& type
) {
269 static void autofs_dev_ioctl_fd_install(unsigned int fd
, struct file
*file
)
271 struct files_struct
*files
= current
->files
;
274 spin_lock(&files
->file_lock
);
275 fdt
= files_fdtable(files
);
276 BUG_ON(fdt
->fd
[fd
] != NULL
);
277 rcu_assign_pointer(fdt
->fd
[fd
], file
);
278 FD_SET(fd
, fdt
->close_on_exec
);
279 spin_unlock(&files
->file_lock
);
284 * Open a file descriptor on the autofs mount point corresponding
285 * to the given path and device number (aka. new_encode_dev(sb->s_dev)).
287 static int autofs_dev_ioctl_open_mountpoint(const char *path
, dev_t devid
)
293 fd
= get_unused_fd();
294 if (likely(fd
>= 0)) {
295 /* Get nameidata of the parent directory */
296 err
= path_lookup(path
, LOOKUP_PARENT
, &nd
);
301 * Search down, within the parent, looking for an
302 * autofs super block that has the device number
303 * corresponding to the autofs fs we want to open.
305 err
= autofs_dev_ioctl_find_super(&nd
, devid
);
311 filp
= dentry_open(nd
.path
.dentry
, nd
.path
.mnt
, O_RDONLY
);
317 autofs_dev_ioctl_fd_install(fd
, filp
);
327 /* Open a file descriptor on an autofs mount point */
328 static int autofs_dev_ioctl_openmount(struct file
*fp
,
329 struct autofs_sb_info
*sbi
,
330 struct autofs_dev_ioctl
*param
)
336 /* param->path has already been checked */
346 fd
= autofs_dev_ioctl_open_mountpoint(path
, devid
);
347 if (unlikely(fd
< 0)) {
357 /* Close file descriptor allocated above (user can also use close(2)). */
358 static int autofs_dev_ioctl_closemount(struct file
*fp
,
359 struct autofs_sb_info
*sbi
,
360 struct autofs_dev_ioctl
*param
)
362 return sys_close(param
->ioctlfd
);
366 * Send "ready" status for an existing wait (either a mount or an expire
369 static int autofs_dev_ioctl_ready(struct file
*fp
,
370 struct autofs_sb_info
*sbi
,
371 struct autofs_dev_ioctl
*param
)
375 token
= (autofs_wqt_t
) param
->arg1
;
376 return autofs4_wait_release(sbi
, token
, 0);
380 * Send "fail" status for an existing wait (either a mount or an expire
383 static int autofs_dev_ioctl_fail(struct file
*fp
,
384 struct autofs_sb_info
*sbi
,
385 struct autofs_dev_ioctl
*param
)
390 token
= (autofs_wqt_t
) param
->arg1
;
391 status
= param
->arg2
? param
->arg2
: -ENOENT
;
392 return autofs4_wait_release(sbi
, token
, status
);
396 * Set the pipe fd for kernel communication to the daemon.
398 * Normally this is set at mount using an option but if we
399 * are reconnecting to a busy mount then we need to use this
400 * to tell the autofs mount about the new kernel pipe fd. In
401 * order to protect mounts against incorrectly setting the
402 * pipefd we also require that the autofs mount be catatonic.
404 * This also sets the process group id used to identify the
405 * controlling process (eg. the owning automount(8) daemon).
407 static int autofs_dev_ioctl_setpipefd(struct file
*fp
,
408 struct autofs_sb_info
*sbi
,
409 struct autofs_dev_ioctl
*param
)
414 if (param
->arg1
== -1)
417 pipefd
= param
->arg1
;
419 mutex_lock(&sbi
->wq_mutex
);
420 if (!sbi
->catatonic
) {
421 mutex_unlock(&sbi
->wq_mutex
);
424 struct file
*pipe
= fget(pipefd
);
425 if (!pipe
->f_op
|| !pipe
->f_op
->write
) {
430 sbi
->oz_pgrp
= task_pgrp_nr(current
);
431 sbi
->pipefd
= pipefd
;
436 mutex_unlock(&sbi
->wq_mutex
);
441 * Make the autofs mount point catatonic, no longer responsive to
442 * mount requests. Also closes the kernel pipe file descriptor.
444 static int autofs_dev_ioctl_catatonic(struct file
*fp
,
445 struct autofs_sb_info
*sbi
,
446 struct autofs_dev_ioctl
*param
)
448 autofs4_catatonic_mode(sbi
);
452 /* Set the autofs mount timeout */
453 static int autofs_dev_ioctl_timeout(struct file
*fp
,
454 struct autofs_sb_info
*sbi
,
455 struct autofs_dev_ioctl
*param
)
457 unsigned long timeout
;
459 timeout
= param
->arg1
;
460 param
->arg1
= sbi
->exp_timeout
/ HZ
;
461 sbi
->exp_timeout
= timeout
* HZ
;
466 * Return the uid and gid of the last request for the mount
468 * When reconstructing an autofs mount tree with active mounts
469 * we need to re-connect to mounts that may have used the original
470 * process uid and gid (or string variations of them) for mount
471 * lookups within the map entry.
473 static int autofs_dev_ioctl_requester(struct file
*fp
,
474 struct autofs_sb_info
*sbi
,
475 struct autofs_dev_ioctl
*param
)
477 struct autofs_info
*ino
;
483 if (param
->size
<= sizeof(*param
)) {
489 devid
= sbi
->sb
->s_dev
;
491 param
->arg1
= param
->arg2
= -1;
493 /* Get nameidata of the parent directory */
494 err
= path_lookup(path
, LOOKUP_PARENT
, &nd
);
498 err
= autofs_dev_ioctl_find_super(&nd
, devid
);
502 ino
= autofs4_dentry_ino(nd
.path
.dentry
);
505 autofs4_expire_wait(nd
.path
.dentry
);
506 spin_lock(&sbi
->fs_lock
);
507 param
->arg1
= ino
->uid
;
508 param
->arg2
= ino
->gid
;
509 spin_unlock(&sbi
->fs_lock
);
519 * Call repeatedly until it returns -EAGAIN, meaning there's nothing
520 * more that can be done.
522 static int autofs_dev_ioctl_expire(struct file
*fp
,
523 struct autofs_sb_info
*sbi
,
524 struct autofs_dev_ioctl
*param
)
526 struct dentry
*dentry
;
527 struct vfsmount
*mnt
;
532 mnt
= fp
->f_path
.mnt
;
534 if (sbi
->type
& AUTOFS_TYPE_TRIGGER
)
535 dentry
= autofs4_expire_direct(sbi
->sb
, mnt
, sbi
, how
);
537 dentry
= autofs4_expire_indirect(sbi
->sb
, mnt
, sbi
, how
);
540 struct autofs_info
*ino
= autofs4_dentry_ino(dentry
);
543 * This is synchronous because it makes the daemon a
546 err
= autofs4_wait(sbi
, dentry
, NFY_EXPIRE
);
548 spin_lock(&sbi
->fs_lock
);
549 if (ino
->flags
& AUTOFS_INF_MOUNTPOINT
) {
550 ino
->flags
&= ~AUTOFS_INF_MOUNTPOINT
;
551 sbi
->sb
->s_root
->d_mounted
++;
553 ino
->flags
&= ~AUTOFS_INF_EXPIRING
;
554 complete_all(&ino
->expire_complete
);
555 spin_unlock(&sbi
->fs_lock
);
562 /* Check if autofs mount point is in use */
563 static int autofs_dev_ioctl_askumount(struct file
*fp
,
564 struct autofs_sb_info
*sbi
,
565 struct autofs_dev_ioctl
*param
)
568 if (may_umount(fp
->f_path
.mnt
))
574 * Check if the given path is a mountpoint.
576 * If we are supplied with the file descriptor of an autofs
577 * mount we're looking for a specific mount. In this case
578 * the path is considered a mountpoint if it is itself a
579 * mountpoint or contains a mount, such as a multi-mount
580 * without a root mount. In this case we return 1 if the
581 * path is a mount point and the super magic of the covering
582 * mount if there is one or 0 if it isn't a mountpoint.
584 * If we aren't supplied with a file descriptor then we
585 * lookup the nameidata of the path and check if it is the
586 * root of a mount. If a type is given we are looking for
587 * a particular autofs mount and if we don't find a match
588 * we return fail. If the located nameidata path is the
589 * root of a mount we return 1 along with the super magic
590 * of the mount or 0 otherwise.
592 * In both cases the the device number (as returned by
593 * new_encode_dev()) is also returned.
595 static int autofs_dev_ioctl_ismountpoint(struct file
*fp
,
596 struct autofs_sb_info
*sbi
,
597 struct autofs_dev_ioctl
*param
)
604 if (param
->size
<= sizeof(*param
)) {
615 if (!fp
|| param
->ioctlfd
== -1) {
616 if (type
== AUTOFS_TYPE_ANY
) {
617 struct super_block
*sb
;
619 err
= path_lookup(path
, LOOKUP_FOLLOW
, &nd
);
623 sb
= nd
.path
.dentry
->d_sb
;
624 param
->arg1
= new_encode_dev(sb
->s_dev
);
626 struct autofs_info
*ino
;
628 err
= path_lookup(path
, LOOKUP_PARENT
, &nd
);
632 err
= autofs_dev_ioctl_find_sbi_type(&nd
, type
);
636 ino
= autofs4_dentry_ino(nd
.path
.dentry
);
637 param
->arg1
= autofs4_get_dev(ino
->sbi
);
641 if (nd
.path
.dentry
->d_inode
&&
642 nd
.path
.mnt
->mnt_root
== nd
.path
.dentry
) {
644 param
->arg2
= nd
.path
.dentry
->d_inode
->i_sb
->s_magic
;
647 dev_t devid
= new_encode_dev(sbi
->sb
->s_dev
);
649 err
= path_lookup(path
, LOOKUP_PARENT
, &nd
);
653 err
= autofs_dev_ioctl_find_super(&nd
, devid
);
657 param
->arg1
= autofs4_get_dev(sbi
);
659 err
= have_submounts(nd
.path
.dentry
);
661 if (nd
.path
.mnt
->mnt_mountpoint
!= nd
.path
.mnt
->mnt_root
) {
662 if (follow_down(&nd
.path
.mnt
, &nd
.path
.dentry
)) {
663 struct inode
*inode
= nd
.path
.dentry
->d_inode
;
664 param
->arg2
= inode
->i_sb
->s_magic
;
676 * Our range of ioctl numbers isn't 0 based so we need to shift
677 * the array index by _IOC_NR(AUTOFS_CTL_IOC_FIRST) for the table
680 #define cmd_idx(cmd) (cmd - _IOC_NR(AUTOFS_DEV_IOCTL_IOC_FIRST))
682 static ioctl_fn
lookup_dev_ioctl(unsigned int cmd
)
688 {cmd_idx(AUTOFS_DEV_IOCTL_VERSION_CMD
), NULL
},
689 {cmd_idx(AUTOFS_DEV_IOCTL_PROTOVER_CMD
),
690 autofs_dev_ioctl_protover
},
691 {cmd_idx(AUTOFS_DEV_IOCTL_PROTOSUBVER_CMD
),
692 autofs_dev_ioctl_protosubver
},
693 {cmd_idx(AUTOFS_DEV_IOCTL_OPENMOUNT_CMD
),
694 autofs_dev_ioctl_openmount
},
695 {cmd_idx(AUTOFS_DEV_IOCTL_CLOSEMOUNT_CMD
),
696 autofs_dev_ioctl_closemount
},
697 {cmd_idx(AUTOFS_DEV_IOCTL_READY_CMD
),
698 autofs_dev_ioctl_ready
},
699 {cmd_idx(AUTOFS_DEV_IOCTL_FAIL_CMD
),
700 autofs_dev_ioctl_fail
},
701 {cmd_idx(AUTOFS_DEV_IOCTL_SETPIPEFD_CMD
),
702 autofs_dev_ioctl_setpipefd
},
703 {cmd_idx(AUTOFS_DEV_IOCTL_CATATONIC_CMD
),
704 autofs_dev_ioctl_catatonic
},
705 {cmd_idx(AUTOFS_DEV_IOCTL_TIMEOUT_CMD
),
706 autofs_dev_ioctl_timeout
},
707 {cmd_idx(AUTOFS_DEV_IOCTL_REQUESTER_CMD
),
708 autofs_dev_ioctl_requester
},
709 {cmd_idx(AUTOFS_DEV_IOCTL_EXPIRE_CMD
),
710 autofs_dev_ioctl_expire
},
711 {cmd_idx(AUTOFS_DEV_IOCTL_ASKUMOUNT_CMD
),
712 autofs_dev_ioctl_askumount
},
713 {cmd_idx(AUTOFS_DEV_IOCTL_ISMOUNTPOINT_CMD
),
714 autofs_dev_ioctl_ismountpoint
}
716 unsigned int idx
= cmd_idx(cmd
);
718 return (idx
>= ARRAY_SIZE(_ioctls
)) ? NULL
: _ioctls
[idx
].fn
;
721 /* ioctl dispatcher */
722 static int _autofs_dev_ioctl(unsigned int command
, struct autofs_dev_ioctl __user
*user
)
724 struct autofs_dev_ioctl
*param
;
726 struct autofs_sb_info
*sbi
;
727 unsigned int cmd_first
, cmd
;
731 /* only root can play with this */
732 if (!capable(CAP_SYS_ADMIN
))
735 cmd_first
= _IOC_NR(AUTOFS_DEV_IOCTL_IOC_FIRST
);
736 cmd
= _IOC_NR(command
);
738 if (_IOC_TYPE(command
) != _IOC_TYPE(AUTOFS_DEV_IOCTL_IOC_FIRST
) ||
739 cmd
- cmd_first
>= AUTOFS_DEV_IOCTL_IOC_COUNT
) {
743 /* Copy the parameters into kernel space. */
744 param
= copy_dev_ioctl(user
);
746 return PTR_ERR(param
);
748 err
= validate_dev_ioctl(command
, param
);
752 /* The validate routine above always sets the version */
753 if (cmd
== AUTOFS_DEV_IOCTL_VERSION_CMD
)
756 fn
= lookup_dev_ioctl(cmd
);
758 AUTOFS_WARN("unknown command 0x%08x", command
);
766 * For obvious reasons the openmount can't have a file
767 * descriptor yet. We don't take a reference to the
768 * file during close to allow for immediate release.
770 if (cmd
!= AUTOFS_DEV_IOCTL_OPENMOUNT_CMD
&&
771 cmd
!= AUTOFS_DEV_IOCTL_CLOSEMOUNT_CMD
) {
772 fp
= fget(param
->ioctlfd
);
774 if (cmd
== AUTOFS_DEV_IOCTL_ISMOUNTPOINT_CMD
)
786 sbi
= autofs_dev_ioctl_sbi(fp
);
787 if (!sbi
|| sbi
->magic
!= AUTOFS_SBI_MAGIC
) {
794 * Admin needs to be able to set the mount catatonic in
795 * order to be able to perform the re-open.
797 if (!autofs4_oz_mode(sbi
) &&
798 cmd
!= AUTOFS_DEV_IOCTL_CATATONIC_CMD
) {
805 err
= fn(fp
, sbi
, param
);
810 if (err
>= 0 && copy_to_user(user
, param
, AUTOFS_DEV_IOCTL_SIZE
))
813 free_dev_ioctl(param
);
817 static long autofs_dev_ioctl(struct file
*file
, uint command
, ulong u
)
820 err
= _autofs_dev_ioctl(command
, (struct autofs_dev_ioctl __user
*) u
);
825 static long autofs_dev_ioctl_compat(struct file
*file
, uint command
, ulong u
)
827 return (long) autofs_dev_ioctl(file
, command
, (ulong
) compat_ptr(u
));
830 #define autofs_dev_ioctl_compat NULL
833 static const struct file_operations _dev_ioctl_fops
= {
834 .unlocked_ioctl
= autofs_dev_ioctl
,
835 .compat_ioctl
= autofs_dev_ioctl_compat
,
836 .owner
= THIS_MODULE
,
839 static struct miscdevice _autofs_dev_ioctl_misc
= {
840 .minor
= MISC_DYNAMIC_MINOR
,
841 .name
= AUTOFS_DEVICE_NAME
,
842 .fops
= &_dev_ioctl_fops
845 /* Register/deregister misc character device */
846 int autofs_dev_ioctl_init(void)
850 r
= misc_register(&_autofs_dev_ioctl_misc
);
852 AUTOFS_ERROR("misc_register failed for control device");
859 void autofs_dev_ioctl_exit(void)
861 misc_deregister(&_autofs_dev_ioctl_misc
);