fs/autofs/autofs_i.h

   1 /*
   2  *  Copyright 1997-1998 Transmeta Corporation - All Rights Reserved
   3  *  Copyright 2005-2006 Ian Kent <raven@themaw.net>
   4  *
   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.
   8  */
   9
  10 /* Internal header file for autofs */
  11
  12 #include <linux/auto_fs.h>
  13 #include <linux/auto_dev-ioctl.h>
  14
  15 #include <linux/kernel.h>
  16 #include <linux/slab.h>
  17 #include <linux/time.h>
  18 #include <linux/string.h>
  19 #include <linux/wait.h>
  20 #include <linux/sched.h>
  21 #include <linux/sched/signal.h>
  22 #include <linux/mount.h>
  23 #include <linux/namei.h>
  24 #include <linux/uaccess.h>
  25 #include <linux/mutex.h>
  26 #include <linux/spinlock.h>
  27 #include <linux/list.h>
  28 #include <linux/completion.h>
  29 #include <linux/file.h>
  30 #include <linux/magic.h>
  31
  32 /* This is the range of ioctl() numbers we claim as ours */
  33 #define AUTOFS_IOC_FIRST     AUTOFS_IOC_READY
  34 #define AUTOFS_IOC_COUNT     32
  35
  36 #define AUTOFS_DEV_IOCTL_IOC_FIRST      (AUTOFS_DEV_IOCTL_VERSION)
  37 #define AUTOFS_DEV_IOCTL_IOC_COUNT \
  38         (AUTOFS_DEV_IOCTL_ISMOUNTPOINT_CMD - AUTOFS_DEV_IOCTL_VERSION_CMD)
  39
  40 #ifdef pr_fmt
  41 #undef pr_fmt
  42 #endif
  43 #define pr_fmt(fmt) KBUILD_MODNAME ":pid:%d:%s: " fmt, current->pid, __func__
  44
  45 extern struct file_system_type autofs_fs_type;
  46
  47 /*
  48  * Unified info structure.  This is pointed to by both the dentry and
  49  * inode structures.  Each file in the filesystem has an instance of this
  50  * structure.  It holds a reference to the dentry, so dentries are never
  51  * flushed while the file exists.  All name lookups are dealt with at the
  52  * dentry level, although the filesystem can interfere in the validation
  53  * process.  Readdir is implemented by traversing the dentry lists.
  54  */
  55 struct autofs_info {
  56         struct dentry   *dentry;
  57         struct inode    *inode;
  58
  59         int             flags;
  60
  61         struct completion expire_complete;
  62
  63         struct list_head active;
  64         int active_count;
  65
  66         struct list_head expiring;
  67
  68         struct autofs_sb_info *sbi;
  69         unsigned long last_used;
  70         atomic_t count;
  71
  72         kuid_t uid;
  73         kgid_t gid;
  74         struct rcu_head rcu;
  75 };
  76
  77 #define AUTOFS_INF_EXPIRING     (1<<0) /* dentry in the process of expiring */
  78 #define AUTOFS_INF_WANT_EXPIRE  (1<<1) /* the dentry is being considered
  79                                         * for expiry, so RCU_walk is
  80                                         * not permitted.  If it progresses to
  81                                         * actual expiry attempt, the flag is
  82                                         * not cleared when EXPIRING is set -
  83                                         * in that case it gets cleared only
  84                                         * when it comes to clearing EXPIRING.
  85                                         */
  86 #define AUTOFS_INF_PENDING      (1<<2) /* dentry pending mount */
  87
  88 struct autofs_wait_queue {
  89         wait_queue_head_t queue;
  90         struct autofs_wait_queue *next;
  91         autofs_wqt_t wait_queue_token;
  92         /* We use the following to see what we are waiting for */
  93         struct qstr name;
  94         u32 dev;
  95         u64 ino;
  96         kuid_t uid;
  97         kgid_t gid;
  98         pid_t pid;
  99         pid_t tgid;
 100         /* This is for status reporting upon return */
 101         int status;
 102         unsigned int wait_ctr;
 103 };
 104
 105 #define AUTOFS_SBI_MAGIC 0x6d4a556d
 106
 107 #define AUTOFS_SBI_CATATONIC    0x0001
 108 #define AUTOFS_SBI_STRICTEXPIRE 0x0002
 109 #define AUTOFS_SBI_IGNORE       0x0004
 110
 111 struct autofs_sb_info {
 112         u32 magic;
 113         int pipefd;
 114         struct file *pipe;
 115         struct pid *oz_pgrp;
 116         int version;
 117         int sub_version;
 118         int min_proto;
 119         int max_proto;
 120         unsigned int flags;
 121         unsigned long exp_timeout;
 122         unsigned int type;
 123         struct super_block *sb;
 124         struct mutex wq_mutex;
 125         struct mutex pipe_mutex;
 126         spinlock_t fs_lock;
 127         struct autofs_wait_queue *queues; /* Wait queue pointer */
 128         spinlock_t lookup_lock;
 129         struct list_head active_list;
 130         struct list_head expiring_list;
 131         struct rcu_head rcu;
 132 };
 133
 134 static inline struct autofs_sb_info *autofs_sbi(struct super_block *sb)
 135 {
 136         return (struct autofs_sb_info *)(sb->s_fs_info);
 137 }
 138
 139 static inline struct autofs_info *autofs_dentry_ino(struct dentry *dentry)
 140 {
 141         return (struct autofs_info *)(dentry->d_fsdata);
 142 }
 143
 144 /* autofs_oz_mode(): do we see the man behind the curtain?  (The
 145  * processes which do manipulations for us in user space sees the raw
 146  * filesystem without "magic".)
 147  */
 148 static inline int autofs_oz_mode(struct autofs_sb_info *sbi)
 149 {
 150         return ((sbi->flags & AUTOFS_SBI_CATATONIC) ||
 151                  task_pgrp(current) == sbi->oz_pgrp);
 152 }
 153
 154 struct inode *autofs_get_inode(struct super_block *, umode_t);
 155 void autofs_free_ino(struct autofs_info *);
 156
 157 /* Expiration */
 158 int is_autofs_dentry(struct dentry *);
 159 int autofs_expire_wait(const struct path *path, int rcu_walk);
 160 int autofs_expire_run(struct super_block *, struct vfsmount *,
 161                       struct autofs_sb_info *,
 162                       struct autofs_packet_expire __user *);
 163 int autofs_do_expire_multi(struct super_block *sb, struct vfsmount *mnt,
 164                            struct autofs_sb_info *sbi, unsigned int how);
 165 int autofs_expire_multi(struct super_block *, struct vfsmount *,
 166                         struct autofs_sb_info *, int __user *);
 167
 168 /* Device node initialization */
 169
 170 int autofs_dev_ioctl_init(void);
 171 void autofs_dev_ioctl_exit(void);
 172
 173 /* Operations structures */
 174
 175 extern const struct inode_operations autofs_symlink_inode_operations;
 176 extern const struct inode_operations autofs_dir_inode_operations;
 177 extern const struct file_operations autofs_dir_operations;
 178 extern const struct file_operations autofs_root_operations;
 179 extern const struct dentry_operations autofs_dentry_operations;
 180
 181 /* VFS automount flags management functions */
 182 static inline void __managed_dentry_set_managed(struct dentry *dentry)
 183 {
 184         dentry->d_flags |= (DCACHE_NEED_AUTOMOUNT|DCACHE_MANAGE_TRANSIT);
 185 }
 186
 187 static inline void managed_dentry_set_managed(struct dentry *dentry)
 188 {
 189         spin_lock(&dentry->d_lock);
 190         __managed_dentry_set_managed(dentry);
 191         spin_unlock(&dentry->d_lock);
 192 }
 193
 194 static inline void __managed_dentry_clear_managed(struct dentry *dentry)
 195 {
 196         dentry->d_flags &= ~(DCACHE_NEED_AUTOMOUNT|DCACHE_MANAGE_TRANSIT);
 197 }
 198
 199 static inline void managed_dentry_clear_managed(struct dentry *dentry)
 200 {
 201         spin_lock(&dentry->d_lock);
 202         __managed_dentry_clear_managed(dentry);
 203         spin_unlock(&dentry->d_lock);
 204 }
 205
 206 /* Initializing function */
 207
 208 int autofs_fill_super(struct super_block *, void *, int);
 209 struct autofs_info *autofs_new_ino(struct autofs_sb_info *);
 210 void autofs_clean_ino(struct autofs_info *);
 211
 212 static inline int autofs_prepare_pipe(struct file *pipe)
 213 {
 214         if (!(pipe->f_mode & FMODE_CAN_WRITE))
 215                 return -EINVAL;
 216         if (!S_ISFIFO(file_inode(pipe)->i_mode))
 217                 return -EINVAL;
 218         /* We want a packet pipe */
 219         pipe->f_flags |= O_DIRECT;
 220         /* We don't expect -EAGAIN */
 221         pipe->f_flags &= ~O_NONBLOCK;
 222         return 0;
 223 }
 224
 225 /* Queue management functions */
 226
 227 int autofs_wait(struct autofs_sb_info *,
 228                  const struct path *, enum autofs_notify);
 229 int autofs_wait_release(struct autofs_sb_info *, autofs_wqt_t, int);
 230 void autofs_catatonic_mode(struct autofs_sb_info *);
 231
 232 static inline u32 autofs_get_dev(struct autofs_sb_info *sbi)
 233 {
 234         return new_encode_dev(sbi->sb->s_dev);
 235 }
 236
 237 static inline u64 autofs_get_ino(struct autofs_sb_info *sbi)
 238 {
 239         return d_inode(sbi->sb->s_root)->i_ino;
 240 }
 241
 242 static inline void __autofs_add_expiring(struct dentry *dentry)
 243 {
 244         struct autofs_sb_info *sbi = autofs_sbi(dentry->d_sb);
 245         struct autofs_info *ino = autofs_dentry_ino(dentry);
 246
 247         if (ino) {
 248                 if (list_empty(&ino->expiring))
 249                         list_add(&ino->expiring, &sbi->expiring_list);
 250         }
 251 }
 252
 253 static inline void autofs_add_expiring(struct dentry *dentry)
 254 {
 255         struct autofs_sb_info *sbi = autofs_sbi(dentry->d_sb);
 256         struct autofs_info *ino = autofs_dentry_ino(dentry);
 257
 258         if (ino) {
 259                 spin_lock(&sbi->lookup_lock);
 260                 if (list_empty(&ino->expiring))
 261                         list_add(&ino->expiring, &sbi->expiring_list);
 262                 spin_unlock(&sbi->lookup_lock);
 263         }
 264 }
 265
 266 static inline void autofs_del_expiring(struct dentry *dentry)
 267 {
 268         struct autofs_sb_info *sbi = autofs_sbi(dentry->d_sb);
 269         struct autofs_info *ino = autofs_dentry_ino(dentry);
 270
 271         if (ino) {
 272                 spin_lock(&sbi->lookup_lock);
 273                 if (!list_empty(&ino->expiring))
 274                         list_del_init(&ino->expiring);
 275                 spin_unlock(&sbi->lookup_lock);
 276         }
 277 }
 278
 279 void autofs_kill_sb(struct super_block *);