xref: /openbmc/linux/fs/autofs/autofs_i.h (revision 7ff836f0)
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 *);
280