Commit | Line | Data |
---|---|---|
1f327613 | 1 | // SPDX-License-Identifier: GPL-2.0-only |
2bad8471 | 2 | /* |
73c592b9 | 3 | * This file contains vfs inode ops for the 9P2000 protocol. |
2bad8471 EVH |
4 | * |
5 | * Copyright (C) 2004 by Eric Van Hensbergen <ericvh@gmail.com> | |
6 | * Copyright (C) 2002 by Ron Minnich <rminnich@lanl.gov> | |
2bad8471 EVH |
7 | */ |
8 | ||
5d385153 JP |
9 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt |
10 | ||
2bad8471 EVH |
11 | #include <linux/module.h> |
12 | #include <linux/errno.h> | |
13 | #include <linux/fs.h> | |
14 | #include <linux/file.h> | |
15 | #include <linux/pagemap.h> | |
16 | #include <linux/stat.h> | |
17 | #include <linux/string.h> | |
2bad8471 | 18 | #include <linux/namei.h> |
e8edc6e0 | 19 | #include <linux/sched.h> |
5a0e3ad6 | 20 | #include <linux/slab.h> |
ebf46264 | 21 | #include <linux/xattr.h> |
85ff872d | 22 | #include <linux/posix_acl.h> |
bd238fb4 LI |
23 | #include <net/9p/9p.h> |
24 | #include <net/9p/client.h> | |
2bad8471 | 25 | |
2bad8471 | 26 | #include "v9fs.h" |
2bad8471 | 27 | #include "v9fs_vfs.h" |
2bad8471 | 28 | #include "fid.h" |
60e78d2c | 29 | #include "cache.h" |
ebf46264 | 30 | #include "xattr.h" |
85ff872d | 31 | #include "acl.h" |
2bad8471 | 32 | |
754661f1 | 33 | static const struct inode_operations v9fs_dir_inode_operations; |
9b6533c9 | 34 | static const struct inode_operations v9fs_dir_inode_operations_dotu; |
754661f1 AV |
35 | static const struct inode_operations v9fs_file_inode_operations; |
36 | static const struct inode_operations v9fs_symlink_inode_operations; | |
f5fc6145 | 37 | |
2bad8471 EVH |
38 | /** |
39 | * unixmode2p9mode - convert unix mode bits to plan 9 | |
40 | * @v9ses: v9fs session information | |
41 | * @mode: mode to convert | |
42 | * | |
43 | */ | |
44 | ||
3eda0de6 | 45 | static u32 unixmode2p9mode(struct v9fs_session_info *v9ses, umode_t mode) |
2bad8471 EVH |
46 | { |
47 | int res; | |
6e195b0f | 48 | |
2bad8471 EVH |
49 | res = mode & 0777; |
50 | if (S_ISDIR(mode)) | |
bd238fb4 | 51 | res |= P9_DMDIR; |
dd6102fb | 52 | if (v9fs_proto_dotu(v9ses)) { |
2bad8471 EVH |
53 | if (v9ses->nodev == 0) { |
54 | if (S_ISSOCK(mode)) | |
bd238fb4 | 55 | res |= P9_DMSOCKET; |
2bad8471 | 56 | if (S_ISFIFO(mode)) |
bd238fb4 | 57 | res |= P9_DMNAMEDPIPE; |
2bad8471 | 58 | if (S_ISBLK(mode)) |
bd238fb4 | 59 | res |= P9_DMDEVICE; |
2bad8471 | 60 | if (S_ISCHR(mode)) |
bd238fb4 | 61 | res |= P9_DMDEVICE; |
2bad8471 EVH |
62 | } |
63 | ||
64 | if ((mode & S_ISUID) == S_ISUID) | |
bd238fb4 | 65 | res |= P9_DMSETUID; |
2bad8471 | 66 | if ((mode & S_ISGID) == S_ISGID) |
bd238fb4 | 67 | res |= P9_DMSETGID; |
d199d652 AL |
68 | if ((mode & S_ISVTX) == S_ISVTX) |
69 | res |= P9_DMSETVTX; | |
2bad8471 | 70 | } |
2bad8471 EVH |
71 | return res; |
72 | } | |
73 | ||
df345c67 AK |
74 | /** |
75 | * p9mode2perm- convert plan9 mode bits to unix permission bits | |
76 | * @v9ses: v9fs session information | |
77 | * @stat: p9_wstat from which mode need to be derived | |
78 | * | |
79 | */ | |
80 | static int p9mode2perm(struct v9fs_session_info *v9ses, | |
81 | struct p9_wstat *stat) | |
82 | { | |
83 | int res; | |
84 | int mode = stat->mode; | |
85 | ||
cd25e15e | 86 | res = mode & 0777; /* S_IRWXUGO */ |
df345c67 AK |
87 | if (v9fs_proto_dotu(v9ses)) { |
88 | if ((mode & P9_DMSETUID) == P9_DMSETUID) | |
89 | res |= S_ISUID; | |
90 | ||
91 | if ((mode & P9_DMSETGID) == P9_DMSETGID) | |
92 | res |= S_ISGID; | |
93 | ||
94 | if ((mode & P9_DMSETVTX) == P9_DMSETVTX) | |
95 | res |= S_ISVTX; | |
96 | } | |
97 | return res; | |
98 | } | |
99 | ||
2bad8471 EVH |
100 | /** |
101 | * p9mode2unixmode- convert plan9 mode bits to unix mode bits | |
102 | * @v9ses: v9fs session information | |
45089142 AK |
103 | * @stat: p9_wstat from which mode need to be derived |
104 | * @rdev: major number, minor number in case of device files. | |
2bad8471 EVH |
105 | * |
106 | */ | |
3eda0de6 AV |
107 | static umode_t p9mode2unixmode(struct v9fs_session_info *v9ses, |
108 | struct p9_wstat *stat, dev_t *rdev) | |
2bad8471 | 109 | { |
05f975cd | 110 | int res, r; |
3eda0de6 | 111 | u32 mode = stat->mode; |
2bad8471 | 112 | |
45089142 | 113 | *rdev = 0; |
df345c67 | 114 | res = p9mode2perm(v9ses, stat); |
2bad8471 | 115 | |
bd238fb4 | 116 | if ((mode & P9_DMDIR) == P9_DMDIR) |
2bad8471 | 117 | res |= S_IFDIR; |
dd6102fb | 118 | else if ((mode & P9_DMSYMLINK) && (v9fs_proto_dotu(v9ses))) |
2bad8471 | 119 | res |= S_IFLNK; |
dd6102fb | 120 | else if ((mode & P9_DMSOCKET) && (v9fs_proto_dotu(v9ses)) |
2bad8471 EVH |
121 | && (v9ses->nodev == 0)) |
122 | res |= S_IFSOCK; | |
dd6102fb | 123 | else if ((mode & P9_DMNAMEDPIPE) && (v9fs_proto_dotu(v9ses)) |
2bad8471 EVH |
124 | && (v9ses->nodev == 0)) |
125 | res |= S_IFIFO; | |
dd6102fb | 126 | else if ((mode & P9_DMDEVICE) && (v9fs_proto_dotu(v9ses)) |
45089142 | 127 | && (v9ses->nodev == 0)) { |
05f975cd | 128 | char type = 0; |
45089142 AK |
129 | int major = -1, minor = -1; |
130 | ||
05f975cd DM |
131 | r = sscanf(stat->extension, "%c %i %i", &type, &major, &minor); |
132 | if (r != 3) { | |
133 | p9_debug(P9_DEBUG_ERROR, | |
134 | "invalid device string, umode will be bogus: %s\n", | |
135 | stat->extension); | |
136 | return res; | |
137 | } | |
45089142 AK |
138 | switch (type) { |
139 | case 'c': | |
140 | res |= S_IFCHR; | |
141 | break; | |
142 | case 'b': | |
143 | res |= S_IFBLK; | |
144 | break; | |
145 | default: | |
5d385153 JP |
146 | p9_debug(P9_DEBUG_ERROR, "Unknown special type %c %s\n", |
147 | type, stat->extension); | |
51958817 | 148 | } |
45089142 AK |
149 | *rdev = MKDEV(major, minor); |
150 | } else | |
2bad8471 EVH |
151 | res |= S_IFREG; |
152 | ||
2bad8471 EVH |
153 | return res; |
154 | } | |
155 | ||
ee443996 EVH |
156 | /** |
157 | * v9fs_uflags2omode- convert posix open flags to plan 9 mode bits | |
158 | * @uflags: flags to convert | |
2e4bef41 | 159 | * @extended: if .u extensions are active |
ee443996 EVH |
160 | */ |
161 | ||
2e4bef41 | 162 | int v9fs_uflags2omode(int uflags, int extended) |
6a3124a3 LI |
163 | { |
164 | int ret; | |
165 | ||
6a3124a3 LI |
166 | switch (uflags&3) { |
167 | default: | |
168 | case O_RDONLY: | |
bd238fb4 | 169 | ret = P9_OREAD; |
6a3124a3 LI |
170 | break; |
171 | ||
172 | case O_WRONLY: | |
bd238fb4 | 173 | ret = P9_OWRITE; |
6a3124a3 LI |
174 | break; |
175 | ||
176 | case O_RDWR: | |
bd238fb4 | 177 | ret = P9_ORDWR; |
6a3124a3 LI |
178 | break; |
179 | } | |
180 | ||
87de39e7 JS |
181 | if (uflags & O_TRUNC) |
182 | ret |= P9_OTRUNC; | |
183 | ||
2e4bef41 EVH |
184 | if (extended) { |
185 | if (uflags & O_EXCL) | |
186 | ret |= P9_OEXCL; | |
187 | ||
188 | if (uflags & O_APPEND) | |
189 | ret |= P9_OAPPEND; | |
190 | } | |
6a3124a3 LI |
191 | |
192 | return ret; | |
193 | } | |
194 | ||
2bad8471 | 195 | /** |
531b1094 | 196 | * v9fs_blank_wstat - helper function to setup a 9P stat structure |
531b1094 | 197 | * @wstat: structure to initialize |
2bad8471 EVH |
198 | * |
199 | */ | |
200 | ||
7a4439c4 | 201 | void |
bd238fb4 | 202 | v9fs_blank_wstat(struct p9_wstat *wstat) |
2bad8471 | 203 | { |
531b1094 LI |
204 | wstat->type = ~0; |
205 | wstat->dev = ~0; | |
206 | wstat->qid.type = ~0; | |
207 | wstat->qid.version = ~0; | |
208 | *((long long *)&wstat->qid.path) = ~0; | |
209 | wstat->mode = ~0; | |
210 | wstat->atime = ~0; | |
211 | wstat->mtime = ~0; | |
212 | wstat->length = ~0; | |
213 | wstat->name = NULL; | |
214 | wstat->uid = NULL; | |
215 | wstat->gid = NULL; | |
216 | wstat->muid = NULL; | |
447c5094 EB |
217 | wstat->n_uid = INVALID_UID; |
218 | wstat->n_gid = INVALID_GID; | |
219 | wstat->n_muid = INVALID_UID; | |
531b1094 | 220 | wstat->extension = NULL; |
2bad8471 EVH |
221 | } |
222 | ||
60e78d2c AK |
223 | /** |
224 | * v9fs_alloc_inode - helper function to allocate an inode | |
bc868036 | 225 | * @sb: The superblock to allocate the inode from |
60e78d2c | 226 | */ |
60e78d2c AK |
227 | struct inode *v9fs_alloc_inode(struct super_block *sb) |
228 | { | |
a78ce05d | 229 | struct v9fs_inode *v9inode; |
6e195b0f | 230 | |
fd60b288 | 231 | v9inode = alloc_inode_sb(sb, v9fs_inode_cache, GFP_KERNEL); |
a78ce05d | 232 | if (!v9inode) |
60e78d2c | 233 | return NULL; |
b3cbea03 | 234 | v9inode->cache_validity = 0; |
5a7e0a8c | 235 | mutex_init(&v9inode->v_mutex); |
874c8ca1 | 236 | return &v9inode->netfs.inode; |
60e78d2c AK |
237 | } |
238 | ||
239 | /** | |
5e8a0770 | 240 | * v9fs_free_inode - destroy an inode |
bc868036 | 241 | * @inode: The inode to be freed |
60e78d2c AK |
242 | */ |
243 | ||
5e8a0770 | 244 | void v9fs_free_inode(struct inode *inode) |
60e78d2c | 245 | { |
a78ce05d | 246 | kmem_cache_free(v9fs_inode_cache, V9FS_I(inode)); |
60e78d2c | 247 | } |
fa0d7e3d | 248 | |
bc899ee1 DH |
249 | /* |
250 | * Set parameters for the netfs library | |
251 | */ | |
9546ac78 | 252 | void v9fs_set_netfs_context(struct inode *inode) |
bc899ee1 | 253 | { |
e81fb419 | 254 | struct v9fs_inode *v9inode = V9FS_I(inode); |
100ccd18 | 255 | netfs_inode_init(&v9inode->netfs, &v9fs_req_ops, true); |
bc899ee1 DH |
256 | } |
257 | ||
5ffc0cb3 | 258 | int v9fs_init_inode(struct v9fs_session_info *v9ses, |
724a0845 | 259 | struct inode *inode, struct p9_qid *qid, umode_t mode, dev_t rdev) |
2bad8471 | 260 | { |
5ffc0cb3 | 261 | int err = 0; |
724a0845 EVH |
262 | struct v9fs_inode *v9inode = V9FS_I(inode); |
263 | ||
264 | memcpy(&v9inode->qid, qid, sizeof(struct p9_qid)); | |
2bb54115 | 265 | |
f2d40141 | 266 | inode_init_owner(&nop_mnt_idmap, inode, NULL, mode); |
2bb54115 | 267 | inode->i_blocks = 0; |
45089142 | 268 | inode->i_rdev = rdev; |
d0242a3a | 269 | simple_inode_init_ts(inode); |
2bb54115 | 270 | inode->i_mapping->a_ops = &v9fs_addr_operations; |
987a6485 | 271 | inode->i_private = NULL; |
2bb54115 AK |
272 | |
273 | switch (mode & S_IFMT) { | |
274 | case S_IFIFO: | |
275 | case S_IFBLK: | |
276 | case S_IFCHR: | |
277 | case S_IFSOCK: | |
4b43516a MK |
278 | if (v9fs_proto_dotl(v9ses)) { |
279 | inode->i_op = &v9fs_file_inode_operations_dotl; | |
4b43516a MK |
280 | } else if (v9fs_proto_dotu(v9ses)) { |
281 | inode->i_op = &v9fs_file_inode_operations; | |
4b43516a | 282 | } else { |
5d385153 JP |
283 | p9_debug(P9_DEBUG_ERROR, |
284 | "special files without extended mode\n"); | |
2bb54115 AK |
285 | err = -EINVAL; |
286 | goto error; | |
2bad8471 | 287 | } |
2bb54115 AK |
288 | init_special_inode(inode, inode->i_mode, inode->i_rdev); |
289 | break; | |
290 | case S_IFREG: | |
9b6533c9 SK |
291 | if (v9fs_proto_dotl(v9ses)) { |
292 | inode->i_op = &v9fs_file_inode_operations_dotl; | |
d9bc0d11 | 293 | inode->i_fop = &v9fs_file_operations_dotl; |
9b6533c9 SK |
294 | } else { |
295 | inode->i_op = &v9fs_file_inode_operations; | |
d9bc0d11 | 296 | inode->i_fop = &v9fs_file_operations; |
9b6533c9 SK |
297 | } |
298 | ||
2bb54115 AK |
299 | break; |
300 | case S_IFLNK: | |
9b6533c9 | 301 | if (!v9fs_proto_dotu(v9ses) && !v9fs_proto_dotl(v9ses)) { |
5d385153 JP |
302 | p9_debug(P9_DEBUG_ERROR, |
303 | "extended modes used with legacy protocol\n"); | |
2bb54115 AK |
304 | err = -EINVAL; |
305 | goto error; | |
306 | } | |
9b6533c9 SK |
307 | |
308 | if (v9fs_proto_dotl(v9ses)) | |
309 | inode->i_op = &v9fs_symlink_inode_operations_dotl; | |
310 | else | |
311 | inode->i_op = &v9fs_symlink_inode_operations; | |
312 | ||
2bb54115 AK |
313 | break; |
314 | case S_IFDIR: | |
315 | inc_nlink(inode); | |
9b6533c9 SK |
316 | if (v9fs_proto_dotl(v9ses)) |
317 | inode->i_op = &v9fs_dir_inode_operations_dotl; | |
318 | else if (v9fs_proto_dotu(v9ses)) | |
319 | inode->i_op = &v9fs_dir_inode_operations_dotu; | |
2bb54115 AK |
320 | else |
321 | inode->i_op = &v9fs_dir_inode_operations; | |
9b6533c9 SK |
322 | |
323 | if (v9fs_proto_dotl(v9ses)) | |
324 | inode->i_fop = &v9fs_dir_operations_dotl; | |
325 | else | |
326 | inode->i_fop = &v9fs_dir_operations; | |
327 | ||
2bb54115 AK |
328 | break; |
329 | default: | |
609eac1c | 330 | p9_debug(P9_DEBUG_ERROR, "BAD mode 0x%hx S_IFMT 0x%x\n", |
5d385153 | 331 | mode, mode & S_IFMT); |
2bb54115 AK |
332 | err = -EINVAL; |
333 | goto error; | |
2bad8471 | 334 | } |
5ffc0cb3 AK |
335 | error: |
336 | return err; | |
2bb54115 | 337 | |
5ffc0cb3 | 338 | } |
2bb54115 | 339 | |
60e78d2c | 340 | /** |
bc868036 | 341 | * v9fs_evict_inode - Remove an inode from the inode cache |
60e78d2c AK |
342 | * @inode: inode to release |
343 | * | |
344 | */ | |
b57922d9 | 345 | void v9fs_evict_inode(struct inode *inode) |
60e78d2c | 346 | { |
4eb31178 EVH |
347 | struct v9fs_inode __maybe_unused *v9inode = V9FS_I(inode); |
348 | __le32 __maybe_unused version; | |
6b39f6d2 | 349 | |
6630036b EVH |
350 | if (!is_bad_inode(inode)) { |
351 | truncate_inode_pages_final(&inode->i_data); | |
4eb31178 | 352 | |
6630036b EVH |
353 | version = cpu_to_le32(v9inode->qid.version); |
354 | netfs_clear_inode_writeback(inode, &version); | |
4eb31178 | 355 | |
6630036b EVH |
356 | clear_inode(inode); |
357 | filemap_fdatawrite(&inode->i_data); | |
60e78d2c | 358 | |
4eb31178 | 359 | #ifdef CONFIG_9P_FSCACHE |
6630036b EVH |
360 | if (v9fs_inode_cookie(v9inode)) |
361 | fscache_relinquish_cookie(v9fs_inode_cookie(v9inode), false); | |
4eb31178 | 362 | #endif |
6630036b EVH |
363 | } else |
364 | clear_inode(inode); | |
60e78d2c AK |
365 | } |
366 | ||
d05dcfdf EVH |
367 | struct inode * |
368 | v9fs_fid_iget(struct super_block *sb, struct p9_fid *fid, bool new) | |
6a3124a3 | 369 | { |
45089142 | 370 | dev_t rdev; |
3eda0de6 AV |
371 | int retval; |
372 | umode_t umode; | |
5ffc0cb3 | 373 | struct inode *inode; |
724a0845 | 374 | struct p9_wstat *st; |
5ffc0cb3 | 375 | struct v9fs_session_info *v9ses = sb->s_fs_info; |
ed80fcfa | 376 | |
724a0845 EVH |
377 | inode = iget_locked(sb, QID2INO(&fid->qid)); |
378 | if (unlikely(!inode)) | |
5ffc0cb3 | 379 | return ERR_PTR(-ENOMEM); |
d05dcfdf EVH |
380 | if (!(inode->i_state & I_NEW)) { |
381 | if (!new) { | |
382 | goto done; | |
383 | } else { | |
384 | p9_debug(P9_DEBUG_VFS, "WARNING: Inode collision %ld\n", | |
385 | inode->i_ino); | |
386 | iput(inode); | |
387 | remove_inode_hash(inode); | |
388 | inode = iget_locked(sb, QID2INO(&fid->qid)); | |
389 | WARN_ON(!(inode->i_state & I_NEW)); | |
390 | } | |
391 | } | |
724a0845 | 392 | |
5ffc0cb3 AK |
393 | /* |
394 | * initialize the inode with the stat info | |
395 | * FIXME!! we may need support for stale inodes | |
396 | * later. | |
397 | */ | |
724a0845 EVH |
398 | st = p9_client_stat(fid); |
399 | if (IS_ERR(st)) { | |
400 | retval = PTR_ERR(st); | |
401 | goto error; | |
402 | } | |
403 | ||
45089142 | 404 | umode = p9mode2unixmode(v9ses, st, &rdev); |
724a0845 EVH |
405 | retval = v9fs_init_inode(v9ses, inode, &fid->qid, umode, rdev); |
406 | v9fs_stat2inode(st, inode, sb, 0); | |
407 | p9stat_free(st); | |
408 | kfree(st); | |
5ffc0cb3 | 409 | if (retval) |
6a3124a3 | 410 | goto error; |
60e78d2c | 411 | |
9546ac78 | 412 | v9fs_set_netfs_context(inode); |
5ffc0cb3 | 413 | v9fs_cache_inode_get_cookie(inode); |
5ffc0cb3 | 414 | unlock_new_inode(inode); |
d05dcfdf | 415 | done: |
5ffc0cb3 | 416 | return inode; |
6a3124a3 | 417 | error: |
0a73d0a2 | 418 | iget_failed(inode); |
5ffc0cb3 | 419 | return ERR_PTR(retval); |
5ffc0cb3 AK |
420 | } |
421 | ||
f88657ce AK |
422 | /** |
423 | * v9fs_at_to_dotl_flags- convert Linux specific AT flags to | |
424 | * plan 9 AT flag. | |
425 | * @flags: flags to convert | |
426 | */ | |
427 | static int v9fs_at_to_dotl_flags(int flags) | |
428 | { | |
429 | int rflags = 0; | |
6e195b0f | 430 | |
f88657ce AK |
431 | if (flags & AT_REMOVEDIR) |
432 | rflags |= P9_DOTL_AT_REMOVEDIR; | |
6e195b0f | 433 | |
f88657ce AK |
434 | return rflags; |
435 | } | |
436 | ||
ac89b2ef EG |
437 | /** |
438 | * v9fs_dec_count - helper functon to drop i_nlink. | |
439 | * | |
440 | * If a directory had nlink <= 2 (including . and ..), then we should not drop | |
441 | * the link count, which indicates the underlying exported fs doesn't maintain | |
442 | * nlink accurately. e.g. | |
443 | * - overlayfs sets nlink to 1 for merged dir | |
444 | * - ext4 (with dir_nlink feature enabled) sets nlink to 1 if a dir has more | |
445 | * than EXT4_LINK_MAX (65000) links. | |
446 | * | |
447 | * @inode: inode whose nlink is being dropped | |
448 | */ | |
449 | static void v9fs_dec_count(struct inode *inode) | |
450 | { | |
d05dcfdf EVH |
451 | if (!S_ISDIR(inode->i_mode) || inode->i_nlink > 2) { |
452 | if (inode->i_nlink) { | |
453 | drop_nlink(inode); | |
454 | } else { | |
455 | p9_debug(P9_DEBUG_VFS, | |
456 | "WARNING: unexpected i_nlink zero %d inode %ld\n", | |
457 | inode->i_nlink, inode->i_ino); | |
458 | } | |
459 | } | |
ac89b2ef EG |
460 | } |
461 | ||
2bad8471 EVH |
462 | /** |
463 | * v9fs_remove - helper function to remove files and directories | |
73c592b9 | 464 | * @dir: directory inode that is being deleted |
48e370ff | 465 | * @dentry: dentry that is being deleted |
fd2916bd | 466 | * @flags: removing a directory |
2bad8471 EVH |
467 | * |
468 | */ | |
469 | ||
48e370ff | 470 | static int v9fs_remove(struct inode *dir, struct dentry *dentry, int flags) |
2bad8471 | 471 | { |
48e370ff AK |
472 | struct inode *inode; |
473 | int retval = -EOPNOTSUPP; | |
474 | struct p9_fid *v9fid, *dfid; | |
475 | struct v9fs_session_info *v9ses; | |
2bad8471 | 476 | |
5d385153 JP |
477 | p9_debug(P9_DEBUG_VFS, "inode: %p dentry: %p rmdir: %x\n", |
478 | dir, dentry, flags); | |
2bad8471 | 479 | |
48e370ff | 480 | v9ses = v9fs_inode2v9ses(dir); |
2b0143b5 | 481 | inode = d_inode(dentry); |
77d5a6b7 | 482 | dfid = v9fs_parent_fid(dentry); |
48e370ff AK |
483 | if (IS_ERR(dfid)) { |
484 | retval = PTR_ERR(dfid); | |
5d385153 | 485 | p9_debug(P9_DEBUG_VFS, "fid lookup failed %d\n", retval); |
48e370ff AK |
486 | return retval; |
487 | } | |
488 | if (v9fs_proto_dotl(v9ses)) | |
f88657ce AK |
489 | retval = p9_client_unlinkat(dfid, dentry->d_name.name, |
490 | v9fs_at_to_dotl_flags(flags)); | |
b48dbb99 | 491 | p9_fid_put(dfid); |
48e370ff AK |
492 | if (retval == -EOPNOTSUPP) { |
493 | /* Try the one based on path */ | |
494 | v9fid = v9fs_fid_clone(dentry); | |
495 | if (IS_ERR(v9fid)) | |
496 | return PTR_ERR(v9fid); | |
497 | retval = p9_client_remove(v9fid); | |
498 | } | |
b271ec47 AK |
499 | if (!retval) { |
500 | /* | |
501 | * directories on unlink should have zero | |
502 | * link count | |
503 | */ | |
48e370ff AK |
504 | if (flags & AT_REMOVEDIR) { |
505 | clear_nlink(inode); | |
ac89b2ef | 506 | v9fs_dec_count(dir); |
b271ec47 | 507 | } else |
ac89b2ef | 508 | v9fs_dec_count(inode); |
d28c61f0 | 509 | |
d05dcfdf EVH |
510 | if (inode->i_nlink <= 0) /* no more refs unhash it */ |
511 | remove_inode_hash(inode); | |
512 | ||
48e370ff | 513 | v9fs_invalidate_inode_attr(inode); |
d28c61f0 | 514 | v9fs_invalidate_inode_attr(dir); |
154372e6 EVH |
515 | |
516 | /* invalidate all fids associated with dentry */ | |
517 | /* NOTE: This will not include open fids */ | |
518 | dentry->d_op->d_release(dentry); | |
b271ec47 | 519 | } |
d994f405 | 520 | return retval; |
2bad8471 EVH |
521 | } |
522 | ||
523 | /** | |
bd238fb4 | 524 | * v9fs_create - Create a file |
ee443996 EVH |
525 | * @v9ses: session information |
526 | * @dir: directory that dentry is being created in | |
bd238fb4 | 527 | * @dentry: dentry that is being created |
0e15597e | 528 | * @extension: 9p2000.u extension string to support devices, etc. |
bd238fb4 LI |
529 | * @perm: create permissions |
530 | * @mode: open mode | |
2bad8471 EVH |
531 | * |
532 | */ | |
bd238fb4 LI |
533 | static struct p9_fid * |
534 | v9fs_create(struct v9fs_session_info *v9ses, struct inode *dir, | |
535 | struct dentry *dentry, char *extension, u32 perm, u8 mode) | |
2bad8471 | 536 | { |
6a3124a3 | 537 | int err; |
7880b43b | 538 | const unsigned char *name; |
6636b6dc | 539 | struct p9_fid *dfid, *ofid = NULL, *fid = NULL; |
6a3124a3 | 540 | struct inode *inode; |
6a3124a3 | 541 | |
4b8e9923 | 542 | p9_debug(P9_DEBUG_VFS, "name %pd\n", dentry); |
51a87c55 | 543 | |
7880b43b | 544 | name = dentry->d_name.name; |
77d5a6b7 | 545 | dfid = v9fs_parent_fid(dentry); |
ba17674f | 546 | if (IS_ERR(dfid)) { |
da977b2c | 547 | err = PTR_ERR(dfid); |
5d385153 | 548 | p9_debug(P9_DEBUG_VFS, "fid lookup failed %d\n", err); |
6d27e64d | 549 | return ERR_PTR(err); |
da977b2c | 550 | } |
6a3124a3 | 551 | |
bd238fb4 | 552 | /* clone a fid to use for creation */ |
7d50a29f | 553 | ofid = clone_fid(dfid); |
bd238fb4 LI |
554 | if (IS_ERR(ofid)) { |
555 | err = PTR_ERR(ofid); | |
5d385153 | 556 | p9_debug(P9_DEBUG_VFS, "p9_client_walk failed %d\n", err); |
dafbe689 | 557 | goto error; |
bd238fb4 | 558 | } |
6a3124a3 | 559 | |
bd238fb4 | 560 | err = p9_client_fcreate(ofid, name, perm, mode, extension); |
51a87c55 | 561 | if (err < 0) { |
5d385153 | 562 | p9_debug(P9_DEBUG_VFS, "p9_client_fcreate failed %d\n", err); |
6a3124a3 | 563 | goto error; |
6d27e64d | 564 | } |
6a3124a3 | 565 | |
b6054793 AK |
566 | if (!(perm & P9_DMLINK)) { |
567 | /* now walk from the parent so we can get unopened fid */ | |
568 | fid = p9_client_walk(dfid, 1, &name, 1); | |
569 | if (IS_ERR(fid)) { | |
570 | err = PTR_ERR(fid); | |
571 | p9_debug(P9_DEBUG_VFS, | |
572 | "p9_client_walk failed %d\n", err); | |
b6054793 AK |
573 | goto error; |
574 | } | |
575 | /* | |
576 | * instantiate inode and assign the unopened fid to the dentry | |
577 | */ | |
d05dcfdf | 578 | inode = v9fs_get_inode_from_fid(v9ses, fid, dir->i_sb, true); |
b6054793 AK |
579 | if (IS_ERR(inode)) { |
580 | err = PTR_ERR(inode); | |
581 | p9_debug(P9_DEBUG_VFS, | |
582 | "inode creation failed %d\n", err); | |
583 | goto error; | |
584 | } | |
dafbe689 | 585 | v9fs_fid_add(dentry, &fid); |
b6054793 | 586 | d_instantiate(dentry, inode); |
6a3124a3 | 587 | } |
b48dbb99 | 588 | p9_fid_put(dfid); |
bd238fb4 | 589 | return ofid; |
bd238fb4 | 590 | error: |
dafbe689 DM |
591 | p9_fid_put(dfid); |
592 | p9_fid_put(ofid); | |
593 | p9_fid_put(fid); | |
bd238fb4 LI |
594 | return ERR_PTR(err); |
595 | } | |
596 | ||
597 | /** | |
e43ae79c | 598 | * v9fs_vfs_create - VFS hook to create a regular file |
6c960e68 | 599 | * @idmap: idmap of the mount |
bc868036 DH |
600 | * @dir: The parent directory |
601 | * @dentry: The name of file to be created | |
602 | * @mode: The UNIX file mode to set | |
603 | * @excl: True if the file must not yet exist | |
e43ae79c MS |
604 | * |
605 | * open(.., O_CREAT) is handled in v9fs_vfs_atomic_open(). This is only called | |
606 | * for mknod(2). | |
607 | * | |
bd238fb4 | 608 | */ |
6a3124a3 | 609 | |
bd238fb4 | 610 | static int |
6c960e68 | 611 | v9fs_vfs_create(struct mnt_idmap *idmap, struct inode *dir, |
549c7297 | 612 | struct dentry *dentry, umode_t mode, bool excl) |
bd238fb4 | 613 | { |
e43ae79c MS |
614 | struct v9fs_session_info *v9ses = v9fs_inode2v9ses(dir); |
615 | u32 perm = unixmode2p9mode(v9ses, mode); | |
616 | struct p9_fid *fid; | |
bd238fb4 | 617 | |
e43ae79c MS |
618 | /* P9_OEXCL? */ |
619 | fid = v9fs_create(v9ses, dir, dentry, NULL, perm, P9_ORDWR); | |
620 | if (IS_ERR(fid)) | |
621 | return PTR_ERR(fid); | |
bd238fb4 | 622 | |
d28c61f0 | 623 | v9fs_invalidate_inode_attr(dir); |
b48dbb99 | 624 | p9_fid_put(fid); |
6a3124a3 LI |
625 | |
626 | return 0; | |
2bad8471 EVH |
627 | } |
628 | ||
629 | /** | |
630 | * v9fs_vfs_mkdir - VFS mkdir hook to create a directory | |
c54bd91e | 631 | * @idmap: idmap of the mount |
ee443996 | 632 | * @dir: inode that is being unlinked |
2bad8471 EVH |
633 | * @dentry: dentry that is being unlinked |
634 | * @mode: mode for new directory | |
635 | * | |
636 | */ | |
637 | ||
c54bd91e | 638 | static int v9fs_vfs_mkdir(struct mnt_idmap *idmap, struct inode *dir, |
549c7297 | 639 | struct dentry *dentry, umode_t mode) |
2bad8471 | 640 | { |
6a3124a3 | 641 | int err; |
bd238fb4 | 642 | u32 perm; |
bd238fb4 | 643 | struct p9_fid *fid; |
d28c61f0 | 644 | struct v9fs_session_info *v9ses; |
6a3124a3 | 645 | |
4b8e9923 | 646 | p9_debug(P9_DEBUG_VFS, "name %pd\n", dentry); |
bd238fb4 | 647 | err = 0; |
6a3124a3 | 648 | v9ses = v9fs_inode2v9ses(dir); |
6a3124a3 | 649 | perm = unixmode2p9mode(v9ses, mode | S_IFDIR); |
bd238fb4 LI |
650 | fid = v9fs_create(v9ses, dir, dentry, NULL, perm, P9_OREAD); |
651 | if (IS_ERR(fid)) { | |
652 | err = PTR_ERR(fid); | |
653 | fid = NULL; | |
d28c61f0 | 654 | } else { |
b271ec47 | 655 | inc_nlink(dir); |
d28c61f0 AK |
656 | v9fs_invalidate_inode_attr(dir); |
657 | } | |
6a3124a3 | 658 | |
bd238fb4 | 659 | if (fid) |
b48dbb99 | 660 | p9_fid_put(fid); |
6a3124a3 | 661 | |
6a3124a3 | 662 | return err; |
2bad8471 EVH |
663 | } |
664 | ||
665 | /** | |
666 | * v9fs_vfs_lookup - VFS lookup hook to "walk" to a new inode | |
667 | * @dir: inode that is being walked from | |
668 | * @dentry: dentry that is being walked to? | |
fd2916bd | 669 | * @flags: lookup flags (unused) |
2bad8471 EVH |
670 | * |
671 | */ | |
672 | ||
53c06f4e | 673 | struct dentry *v9fs_vfs_lookup(struct inode *dir, struct dentry *dentry, |
00cd8dd3 | 674 | unsigned int flags) |
2bad8471 | 675 | { |
73f50717 | 676 | struct dentry *res; |
2bad8471 | 677 | struct v9fs_session_info *v9ses; |
bd238fb4 | 678 | struct p9_fid *dfid, *fid; |
2bad8471 | 679 | struct inode *inode; |
7880b43b | 680 | const unsigned char *name; |
2bad8471 | 681 | |
4b8e9923 AV |
682 | p9_debug(P9_DEBUG_VFS, "dir: %p dentry: (%pd) %p flags: %x\n", |
683 | dir, dentry, dentry, flags); | |
2bad8471 | 684 | |
11e9b49b SK |
685 | if (dentry->d_name.len > NAME_MAX) |
686 | return ERR_PTR(-ENAMETOOLONG); | |
687 | ||
2bad8471 | 688 | v9ses = v9fs_inode2v9ses(dir); |
a534c8d1 | 689 | /* We can walk d_parent because we hold the dir->i_mutex */ |
77d5a6b7 | 690 | dfid = v9fs_parent_fid(dentry); |
bd238fb4 | 691 | if (IS_ERR(dfid)) |
e231c2ee | 692 | return ERR_CAST(dfid); |
bd238fb4 | 693 | |
73f50717 AK |
694 | /* |
695 | * Make sure we don't use a wrong inode due to parallel | |
696 | * unlink. For cached mode create calls request for new | |
697 | * inode. But with cache disabled, lookup should do this. | |
698 | */ | |
500e2ab6 AV |
699 | name = dentry->d_name.name; |
700 | fid = p9_client_walk(dfid, 1, &name, 1); | |
b48dbb99 | 701 | p9_fid_put(dfid); |
500e2ab6 AV |
702 | if (fid == ERR_PTR(-ENOENT)) |
703 | inode = NULL; | |
704 | else if (IS_ERR(fid)) | |
705 | inode = ERR_CAST(fid); | |
73f50717 | 706 | else |
d05dcfdf | 707 | inode = v9fs_get_inode_from_fid(v9ses, fid, dir->i_sb, false); |
73f50717 AK |
708 | /* |
709 | * If we had a rename on the server and a parallel lookup | |
710 | * for the new name, then make sure we instantiate with | |
711 | * the new name. ie look up for a/b, while on server somebody | |
712 | * moved b under k and client parallely did a lookup for | |
713 | * k/b. | |
714 | */ | |
41d28bca | 715 | res = d_splice_alias(inode, dentry); |
500e2ab6 AV |
716 | if (!IS_ERR(fid)) { |
717 | if (!res) | |
dafbe689 | 718 | v9fs_fid_add(dentry, &fid); |
500e2ab6 | 719 | else if (!IS_ERR(res)) |
dafbe689 | 720 | v9fs_fid_add(res, &fid); |
500e2ab6 | 721 | else |
b48dbb99 | 722 | p9_fid_put(fid); |
500e2ab6 | 723 | } |
7b5be621 | 724 | return res; |
2bad8471 EVH |
725 | } |
726 | ||
d9585277 | 727 | static int |
e43ae79c | 728 | v9fs_vfs_atomic_open(struct inode *dir, struct dentry *dentry, |
6e195b0f | 729 | struct file *file, unsigned int flags, umode_t mode) |
e43ae79c MS |
730 | { |
731 | int err; | |
732 | u32 perm; | |
4eb31178 | 733 | struct v9fs_inode __maybe_unused *v9inode; |
e43ae79c | 734 | struct v9fs_session_info *v9ses; |
1543b4c5 | 735 | struct p9_fid *fid; |
e43ae79c | 736 | struct dentry *res = NULL; |
987a6485 | 737 | struct inode *inode; |
1543b4c5 | 738 | int p9_omode; |
e43ae79c | 739 | |
00699ad8 | 740 | if (d_in_lookup(dentry)) { |
00cd8dd3 | 741 | res = v9fs_vfs_lookup(dir, dentry, 0); |
e43ae79c | 742 | if (IS_ERR(res)) |
d9585277 | 743 | return PTR_ERR(res); |
e43ae79c MS |
744 | |
745 | if (res) | |
746 | dentry = res; | |
747 | } | |
748 | ||
749 | /* Only creates */ | |
2b0143b5 | 750 | if (!(flags & O_CREAT) || d_really_is_positive(dentry)) |
e45198a6 | 751 | return finish_no_open(file, res); |
e43ae79c | 752 | |
e43ae79c MS |
753 | v9ses = v9fs_inode2v9ses(dir); |
754 | perm = unixmode2p9mode(v9ses, mode); | |
1543b4c5 EVH |
755 | p9_omode = v9fs_uflags2omode(flags, v9fs_proto_dotu(v9ses)); |
756 | ||
4eb31178 | 757 | if ((v9ses->cache & CACHE_WRITEBACK) && (p9_omode & P9_OWRITE)) { |
21e26d5e | 758 | p9_omode = (p9_omode & ~P9_OWRITE) | P9_ORDWR; |
1543b4c5 EVH |
759 | p9_debug(P9_DEBUG_CACHE, |
760 | "write-only file with writeback enabled, creating w/ O_RDWR\n"); | |
761 | } | |
762 | fid = v9fs_create(v9ses, dir, dentry, NULL, perm, p9_omode); | |
e43ae79c MS |
763 | if (IS_ERR(fid)) { |
764 | err = PTR_ERR(fid); | |
e43ae79c MS |
765 | goto error; |
766 | } | |
767 | ||
768 | v9fs_invalidate_inode_attr(dir); | |
987a6485 GK |
769 | inode = d_inode(dentry); |
770 | v9inode = V9FS_I(inode); | |
be12af3e | 771 | err = finish_open(file, dentry, generic_file_open); |
30d90494 | 772 | if (err) |
e43ae79c | 773 | goto error; |
e43ae79c | 774 | |
30d90494 | 775 | file->private_data = fid; |
4eb31178 EVH |
776 | #ifdef CONFIG_9P_FSCACHE |
777 | if (v9ses->cache & CACHE_FSCACHE) | |
24e42e32 DH |
778 | fscache_use_cookie(v9fs_inode_cookie(v9inode), |
779 | file->f_mode & FMODE_WRITE); | |
4eb31178 | 780 | #endif |
1543b4c5 EVH |
781 | |
782 | v9fs_fid_add_modes(fid, v9ses->flags, v9ses->cache, file->f_flags); | |
dafbe689 | 783 | v9fs_open_fid_add(inode, &fid); |
e43ae79c | 784 | |
73a09dd9 | 785 | file->f_mode |= FMODE_CREATED; |
e43ae79c MS |
786 | out: |
787 | dput(res); | |
d9585277 | 788 | return err; |
e43ae79c MS |
789 | |
790 | error: | |
dafbe689 | 791 | p9_fid_put(fid); |
e43ae79c MS |
792 | goto out; |
793 | } | |
794 | ||
2bad8471 EVH |
795 | /** |
796 | * v9fs_vfs_unlink - VFS unlink hook to delete an inode | |
797 | * @i: inode that is being unlinked | |
73c592b9 | 798 | * @d: dentry that is being unlinked |
2bad8471 EVH |
799 | * |
800 | */ | |
801 | ||
53c06f4e | 802 | int v9fs_vfs_unlink(struct inode *i, struct dentry *d) |
2bad8471 EVH |
803 | { |
804 | return v9fs_remove(i, d, 0); | |
805 | } | |
806 | ||
807 | /** | |
808 | * v9fs_vfs_rmdir - VFS unlink hook to delete a directory | |
809 | * @i: inode that is being unlinked | |
73c592b9 | 810 | * @d: dentry that is being unlinked |
2bad8471 EVH |
811 | * |
812 | */ | |
813 | ||
53c06f4e | 814 | int v9fs_vfs_rmdir(struct inode *i, struct dentry *d) |
2bad8471 | 815 | { |
48e370ff | 816 | return v9fs_remove(i, d, AT_REMOVEDIR); |
2bad8471 EVH |
817 | } |
818 | ||
819 | /** | |
820 | * v9fs_vfs_rename - VFS hook to rename an inode | |
e18275ae | 821 | * @idmap: The idmap of the mount |
2bad8471 EVH |
822 | * @old_dir: old dir inode |
823 | * @old_dentry: old dentry | |
824 | * @new_dir: new dir inode | |
825 | * @new_dentry: new dentry | |
bc868036 | 826 | * @flags: RENAME_* flags |
2bad8471 EVH |
827 | * |
828 | */ | |
829 | ||
53c06f4e | 830 | int |
e18275ae | 831 | v9fs_vfs_rename(struct mnt_idmap *idmap, struct inode *old_dir, |
549c7297 CB |
832 | struct dentry *old_dentry, struct inode *new_dir, |
833 | struct dentry *new_dentry, unsigned int flags) | |
2bad8471 | 834 | { |
d28c61f0 | 835 | int retval; |
bd238fb4 | 836 | struct inode *old_inode; |
b271ec47 | 837 | struct inode *new_inode; |
bd238fb4 | 838 | struct v9fs_session_info *v9ses; |
dafbe689 DM |
839 | struct p9_fid *oldfid = NULL, *dfid = NULL; |
840 | struct p9_fid *olddirfid = NULL; | |
841 | struct p9_fid *newdirfid = NULL; | |
bd238fb4 | 842 | struct p9_wstat wstat; |
2bad8471 | 843 | |
1cd66c93 MS |
844 | if (flags) |
845 | return -EINVAL; | |
846 | ||
5d385153 | 847 | p9_debug(P9_DEBUG_VFS, "\n"); |
2b0143b5 DH |
848 | old_inode = d_inode(old_dentry); |
849 | new_inode = d_inode(new_dentry); | |
bd238fb4 LI |
850 | v9ses = v9fs_inode2v9ses(old_inode); |
851 | oldfid = v9fs_fid_lookup(old_dentry); | |
ba17674f | 852 | if (IS_ERR(oldfid)) |
da977b2c EVH |
853 | return PTR_ERR(oldfid); |
854 | ||
6636b6dc JW |
855 | dfid = v9fs_parent_fid(old_dentry); |
856 | olddirfid = clone_fid(dfid); | |
dafbe689 DM |
857 | p9_fid_put(dfid); |
858 | dfid = NULL; | |
6636b6dc | 859 | |
ba17674f | 860 | if (IS_ERR(olddirfid)) { |
da977b2c | 861 | retval = PTR_ERR(olddirfid); |
dafbe689 | 862 | goto error; |
da977b2c EVH |
863 | } |
864 | ||
6636b6dc JW |
865 | dfid = v9fs_parent_fid(new_dentry); |
866 | newdirfid = clone_fid(dfid); | |
b48dbb99 | 867 | p9_fid_put(dfid); |
dafbe689 | 868 | dfid = NULL; |
6636b6dc | 869 | |
ba17674f | 870 | if (IS_ERR(newdirfid)) { |
da977b2c | 871 | retval = PTR_ERR(newdirfid); |
dafbe689 | 872 | goto error; |
2bad8471 EVH |
873 | } |
874 | ||
a534c8d1 | 875 | down_write(&v9ses->rename_sem); |
4681dbda | 876 | if (v9fs_proto_dotl(v9ses)) { |
9e8fb38e AK |
877 | retval = p9_client_renameat(olddirfid, old_dentry->d_name.name, |
878 | newdirfid, new_dentry->d_name.name); | |
879 | if (retval == -EOPNOTSUPP) | |
880 | retval = p9_client_rename(oldfid, newdirfid, | |
881 | new_dentry->d_name.name); | |
882 | if (retval != -EOPNOTSUPP) | |
dafbe689 | 883 | goto error_locked; |
4681dbda | 884 | } |
a534c8d1 AK |
885 | if (old_dentry->d_parent != new_dentry->d_parent) { |
886 | /* | |
887 | * 9P .u can only handle file rename in the same directory | |
888 | */ | |
4681dbda | 889 | |
5d385153 | 890 | p9_debug(P9_DEBUG_ERROR, "old dir and new dir are different\n"); |
621997cd | 891 | retval = -EXDEV; |
dafbe689 | 892 | goto error_locked; |
2bad8471 | 893 | } |
531b1094 | 894 | v9fs_blank_wstat(&wstat); |
ba17674f | 895 | wstat.muid = v9ses->uname; |
7880b43b | 896 | wstat.name = new_dentry->d_name.name; |
bd238fb4 | 897 | retval = p9_client_wstat(oldfid, &wstat); |
2bad8471 | 898 | |
dafbe689 | 899 | error_locked: |
b271ec47 AK |
900 | if (!retval) { |
901 | if (new_inode) { | |
902 | if (S_ISDIR(new_inode->i_mode)) | |
903 | clear_nlink(new_inode); | |
904 | else | |
ac89b2ef | 905 | v9fs_dec_count(new_inode); |
b271ec47 AK |
906 | } |
907 | if (S_ISDIR(old_inode->i_mode)) { | |
908 | if (!new_inode) | |
909 | inc_nlink(new_dir); | |
ac89b2ef | 910 | v9fs_dec_count(old_dir); |
b271ec47 | 911 | } |
3bc86de3 | 912 | v9fs_invalidate_inode_attr(old_inode); |
d28c61f0 AK |
913 | v9fs_invalidate_inode_attr(old_dir); |
914 | v9fs_invalidate_inode_attr(new_dir); | |
3bc86de3 | 915 | |
a534c8d1 AK |
916 | /* successful rename */ |
917 | d_move(old_dentry, new_dentry); | |
b271ec47 | 918 | } |
a534c8d1 | 919 | up_write(&v9ses->rename_sem); |
2bad8471 | 920 | |
dafbe689 DM |
921 | error: |
922 | p9_fid_put(newdirfid); | |
b48dbb99 | 923 | p9_fid_put(olddirfid); |
b48dbb99 | 924 | p9_fid_put(oldfid); |
2bad8471 EVH |
925 | return retval; |
926 | } | |
927 | ||
928 | /** | |
943ffb58 | 929 | * v9fs_vfs_getattr - retrieve file metadata |
b74d24f7 | 930 | * @idmap: idmap of the mount |
a528d35e | 931 | * @path: Object to query |
ee443996 | 932 | * @stat: metadata structure to populate |
a528d35e DH |
933 | * @request_mask: Mask of STATX_xxx flags indicating the caller's interests |
934 | * @flags: AT_STATX_xxx setting | |
2bad8471 EVH |
935 | * |
936 | */ | |
937 | ||
938 | static int | |
b74d24f7 | 939 | v9fs_vfs_getattr(struct mnt_idmap *idmap, const struct path *path, |
549c7297 | 940 | struct kstat *stat, u32 request_mask, unsigned int flags) |
2bad8471 | 941 | { |
a528d35e | 942 | struct dentry *dentry = path->dentry; |
d9bc0d11 | 943 | struct inode *inode = d_inode(dentry); |
bd238fb4 LI |
944 | struct v9fs_session_info *v9ses; |
945 | struct p9_fid *fid; | |
51a87c55 | 946 | struct p9_wstat *st; |
bd238fb4 | 947 | |
5d385153 | 948 | p9_debug(P9_DEBUG_VFS, "dentry: %p\n", dentry); |
42869c8a | 949 | v9ses = v9fs_dentry2v9ses(dentry); |
4eb31178 | 950 | if (v9ses->cache & (CACHE_META|CACHE_LOOSE)) { |
0d72b928 | 951 | generic_fillattr(&nop_mnt_idmap, request_mask, inode, stat); |
a1211908 | 952 | return 0; |
4eb31178 | 953 | } else if (v9ses->cache & CACHE_WRITEBACK) { |
d9bc0d11 EVH |
954 | if (S_ISREG(inode->i_mode)) { |
955 | int retval = filemap_fdatawrite(inode->i_mapping); | |
956 | ||
957 | if (retval) | |
958 | p9_debug(P9_DEBUG_ERROR, | |
959 | "flushing writeback during getattr returned %d\n", retval); | |
960 | } | |
a1211908 | 961 | } |
bd238fb4 LI |
962 | fid = v9fs_fid_lookup(dentry); |
963 | if (IS_ERR(fid)) | |
da977b2c | 964 | return PTR_ERR(fid); |
2bad8471 | 965 | |
bd238fb4 | 966 | st = p9_client_stat(fid); |
b48dbb99 | 967 | p9_fid_put(fid); |
bd238fb4 LI |
968 | if (IS_ERR(st)) |
969 | return PTR_ERR(st); | |
2bad8471 | 970 | |
5e3cc1ee | 971 | v9fs_stat2inode(st, d_inode(dentry), dentry->d_sb, 0); |
0d72b928 | 972 | generic_fillattr(&nop_mnt_idmap, request_mask, d_inode(dentry), stat); |
2bad8471 | 973 | |
62b2be59 | 974 | p9stat_free(st); |
bd238fb4 LI |
975 | kfree(st); |
976 | return 0; | |
2bad8471 EVH |
977 | } |
978 | ||
979 | /** | |
980 | * v9fs_vfs_setattr - set file metadata | |
c1632a0f | 981 | * @idmap: idmap of the mount |
2bad8471 EVH |
982 | * @dentry: file whose metadata to set |
983 | * @iattr: metadata assignment structure | |
984 | * | |
985 | */ | |
986 | ||
c1632a0f | 987 | static int v9fs_vfs_setattr(struct mnt_idmap *idmap, |
549c7297 | 988 | struct dentry *dentry, struct iattr *iattr) |
2bad8471 | 989 | { |
6636b6dc | 990 | int retval, use_dentry = 0; |
24e42e32 | 991 | struct inode *inode = d_inode(dentry); |
bd238fb4 | 992 | struct v9fs_session_info *v9ses; |
66246641 | 993 | struct p9_fid *fid = NULL; |
bd238fb4 | 994 | struct p9_wstat wstat; |
2bad8471 | 995 | |
5d385153 | 996 | p9_debug(P9_DEBUG_VFS, "\n"); |
c1632a0f | 997 | retval = setattr_prepare(&nop_mnt_idmap, dentry, iattr); |
059c138b AK |
998 | if (retval) |
999 | return retval; | |
1000 | ||
42869c8a | 1001 | v9ses = v9fs_dentry2v9ses(dentry); |
66246641 JW |
1002 | if (iattr->ia_valid & ATTR_FILE) { |
1003 | fid = iattr->ia_file->private_data; | |
1004 | WARN_ON(!fid); | |
1005 | } | |
6636b6dc | 1006 | if (!fid) { |
66246641 | 1007 | fid = v9fs_fid_lookup(dentry); |
6636b6dc JW |
1008 | use_dentry = 1; |
1009 | } | |
6e195b0f | 1010 | if (IS_ERR(fid)) |
da977b2c | 1011 | return PTR_ERR(fid); |
2bad8471 | 1012 | |
531b1094 | 1013 | v9fs_blank_wstat(&wstat); |
2bad8471 | 1014 | if (iattr->ia_valid & ATTR_MODE) |
531b1094 | 1015 | wstat.mode = unixmode2p9mode(v9ses, iattr->ia_mode); |
2bad8471 EVH |
1016 | |
1017 | if (iattr->ia_valid & ATTR_MTIME) | |
531b1094 | 1018 | wstat.mtime = iattr->ia_mtime.tv_sec; |
2bad8471 EVH |
1019 | |
1020 | if (iattr->ia_valid & ATTR_ATIME) | |
531b1094 | 1021 | wstat.atime = iattr->ia_atime.tv_sec; |
2bad8471 EVH |
1022 | |
1023 | if (iattr->ia_valid & ATTR_SIZE) | |
531b1094 | 1024 | wstat.length = iattr->ia_size; |
2bad8471 | 1025 | |
dd6102fb | 1026 | if (v9fs_proto_dotu(v9ses)) { |
531b1094 LI |
1027 | if (iattr->ia_valid & ATTR_UID) |
1028 | wstat.n_uid = iattr->ia_uid; | |
2bad8471 | 1029 | |
531b1094 LI |
1030 | if (iattr->ia_valid & ATTR_GID) |
1031 | wstat.n_gid = iattr->ia_gid; | |
2bad8471 | 1032 | } |
059c138b | 1033 | |
3dc5436a | 1034 | /* Write all dirty data */ |
d9bc0d11 EVH |
1035 | if (d_is_reg(dentry)) { |
1036 | retval = filemap_fdatawrite(inode->i_mapping); | |
1037 | if (retval) | |
1038 | p9_debug(P9_DEBUG_ERROR, | |
1039 | "flushing writeback during setattr returned %d\n", retval); | |
1040 | } | |
3dc5436a | 1041 | |
f10fc50f | 1042 | retval = p9_client_wstat(fid, &wstat); |
6636b6dc JW |
1043 | |
1044 | if (use_dentry) | |
b48dbb99 | 1045 | p9_fid_put(fid); |
6636b6dc | 1046 | |
f10fc50f AK |
1047 | if (retval < 0) |
1048 | return retval; | |
059c138b AK |
1049 | |
1050 | if ((iattr->ia_valid & ATTR_SIZE) && | |
d9bc0d11 | 1051 | iattr->ia_size != i_size_read(inode)) { |
24e42e32 | 1052 | truncate_setsize(inode, iattr->ia_size); |
80105ed2 | 1053 | netfs_resize_file(netfs_inode(inode), iattr->ia_size, true); |
1543b4c5 | 1054 | |
4eb31178 EVH |
1055 | #ifdef CONFIG_9P_FSCACHE |
1056 | if (v9ses->cache & CACHE_FSCACHE) { | |
1057 | struct v9fs_inode *v9inode = V9FS_I(inode); | |
1058 | ||
d9bc0d11 | 1059 | fscache_resize_cookie(v9fs_inode_cookie(v9inode), iattr->ia_size); |
4eb31178 EVH |
1060 | } |
1061 | #endif | |
24e42e32 | 1062 | } |
059c138b | 1063 | |
24e42e32 | 1064 | v9fs_invalidate_inode_attr(inode); |
2bad8471 | 1065 | |
c1632a0f | 1066 | setattr_copy(&nop_mnt_idmap, inode, iattr); |
24e42e32 | 1067 | mark_inode_dirty(inode); |
1025774c | 1068 | return 0; |
2bad8471 EVH |
1069 | } |
1070 | ||
1071 | /** | |
531b1094 LI |
1072 | * v9fs_stat2inode - populate an inode structure with mistat info |
1073 | * @stat: Plan 9 metadata (mistat) structure | |
2bad8471 EVH |
1074 | * @inode: inode to populate |
1075 | * @sb: superblock of filesystem | |
5e3cc1ee | 1076 | * @flags: control flags (e.g. V9FS_STAT2INODE_KEEP_ISIZE) |
2bad8471 EVH |
1077 | * |
1078 | */ | |
1079 | ||
1080 | void | |
51a87c55 | 1081 | v9fs_stat2inode(struct p9_wstat *stat, struct inode *inode, |
5e3cc1ee | 1082 | struct super_block *sb, unsigned int flags) |
2bad8471 | 1083 | { |
3eda0de6 | 1084 | umode_t mode; |
2bad8471 | 1085 | struct v9fs_session_info *v9ses = sb->s_fs_info; |
b3cbea03 | 1086 | struct v9fs_inode *v9inode = V9FS_I(inode); |
2bad8471 | 1087 | |
d0242a3a JL |
1088 | inode_set_atime(inode, stat->atime, 0); |
1089 | inode_set_mtime(inode, stat->mtime, 0); | |
4f871800 | 1090 | inode_set_ctime(inode, stat->mtime, 0); |
2bad8471 | 1091 | |
bd32b82d LI |
1092 | inode->i_uid = v9ses->dfltuid; |
1093 | inode->i_gid = v9ses->dfltgid; | |
2bad8471 | 1094 | |
dd6102fb | 1095 | if (v9fs_proto_dotu(v9ses)) { |
531b1094 LI |
1096 | inode->i_uid = stat->n_uid; |
1097 | inode->i_gid = stat->n_gid; | |
2bad8471 | 1098 | } |
5717144a | 1099 | if ((S_ISREG(inode->i_mode)) || (S_ISDIR(inode->i_mode))) { |
9652c732 AV |
1100 | if (v9fs_proto_dotu(v9ses)) { |
1101 | unsigned int i_nlink; | |
5717144a | 1102 | /* |
9652c732 AV |
1103 | * Hadlink support got added later to the .u extension. |
1104 | * So there can be a server out there that doesn't | |
1105 | * support this even with .u extension. That would | |
1106 | * just leave us with stat->extension being an empty | |
1107 | * string, though. | |
5717144a | 1108 | */ |
5717144a | 1109 | /* HARDLINKCOUNT %u */ |
9652c732 AV |
1110 | if (sscanf(stat->extension, |
1111 | " HARDLINKCOUNT %u", &i_nlink) == 1) | |
bfe86848 | 1112 | set_nlink(inode, i_nlink); |
5717144a AK |
1113 | } |
1114 | } | |
df345c67 | 1115 | mode = p9mode2perm(v9ses, stat); |
45089142 AK |
1116 | mode |= inode->i_mode & ~S_IALLUGO; |
1117 | inode->i_mode = mode; | |
2bad8471 | 1118 | |
80105ed2 | 1119 | v9inode->netfs.remote_i_size = stat->length; |
5e3cc1ee HT |
1120 | if (!(flags & V9FS_STAT2INODE_KEEP_ISIZE)) |
1121 | v9fs_i_size_write(inode, stat->length); | |
bd238fb4 | 1122 | /* not real number of blocks, but 512 byte ones ... */ |
5e3cc1ee | 1123 | inode->i_blocks = (stat->length + 512 - 1) >> 9; |
b3cbea03 | 1124 | v9inode->cache_validity &= ~V9FS_INO_INVALID_ATTR; |
2bad8471 EVH |
1125 | } |
1126 | ||
2bad8471 | 1127 | /** |
6b255391 | 1128 | * v9fs_vfs_get_link - follow a symlink path |
2bad8471 | 1129 | * @dentry: dentry for symlink |
6b255391 | 1130 | * @inode: inode for symlink |
fceef393 | 1131 | * @done: delayed call for when we are done with the return value |
2bad8471 EVH |
1132 | */ |
1133 | ||
6b255391 | 1134 | static const char *v9fs_vfs_get_link(struct dentry *dentry, |
fceef393 AV |
1135 | struct inode *inode, |
1136 | struct delayed_call *done) | |
2bad8471 | 1137 | { |
6b255391 AV |
1138 | struct v9fs_session_info *v9ses; |
1139 | struct p9_fid *fid; | |
51a87c55 | 1140 | struct p9_wstat *st; |
680baacb | 1141 | char *res; |
2bad8471 | 1142 | |
6b255391 AV |
1143 | if (!dentry) |
1144 | return ERR_PTR(-ECHILD); | |
1145 | ||
1146 | v9ses = v9fs_dentry2v9ses(dentry); | |
e5690f26 DM |
1147 | if (!v9fs_proto_dotu(v9ses)) |
1148 | return ERR_PTR(-EBADF); | |
1149 | ||
90e4fc88 | 1150 | p9_debug(P9_DEBUG_VFS, "%pd\n", dentry); |
e5690f26 | 1151 | fid = v9fs_fid_lookup(dentry); |
90e4fc88 | 1152 | |
ba17674f | 1153 | if (IS_ERR(fid)) |
90e4fc88 | 1154 | return ERR_CAST(fid); |
2bad8471 | 1155 | |
bd238fb4 | 1156 | st = p9_client_stat(fid); |
b48dbb99 | 1157 | p9_fid_put(fid); |
bd238fb4 | 1158 | if (IS_ERR(st)) |
90e4fc88 | 1159 | return ERR_CAST(st); |
2bad8471 | 1160 | |
bd238fb4 | 1161 | if (!(st->mode & P9_DMSYMLINK)) { |
90e4fc88 AV |
1162 | p9stat_free(st); |
1163 | kfree(st); | |
1164 | return ERR_PTR(-EINVAL); | |
2bad8471 | 1165 | } |
680baacb | 1166 | res = st->extension; |
90e4fc88 | 1167 | st->extension = NULL; |
680baacb AV |
1168 | if (strlen(res) >= PATH_MAX) |
1169 | res[PATH_MAX - 1] = '\0'; | |
1170 | ||
62b2be59 | 1171 | p9stat_free(st); |
bd238fb4 | 1172 | kfree(st); |
fceef393 AV |
1173 | set_delayed_call(done, kfree_link, res); |
1174 | return res; | |
2bad8471 EVH |
1175 | } |
1176 | ||
ee443996 EVH |
1177 | /** |
1178 | * v9fs_vfs_mkspecial - create a special file | |
1179 | * @dir: inode to create special file in | |
1180 | * @dentry: dentry to create | |
fd2916bd | 1181 | * @perm: mode to create special file |
ee443996 EVH |
1182 | * @extension: 9p2000.u format extension string representing special file |
1183 | * | |
1184 | */ | |
1185 | ||
531b1094 | 1186 | static int v9fs_vfs_mkspecial(struct inode *dir, struct dentry *dentry, |
c2837de7 | 1187 | u32 perm, const char *extension) |
2bad8471 | 1188 | { |
bd238fb4 | 1189 | struct p9_fid *fid; |
d28c61f0 | 1190 | struct v9fs_session_info *v9ses; |
2bad8471 | 1191 | |
6a3124a3 | 1192 | v9ses = v9fs_inode2v9ses(dir); |
dd6102fb | 1193 | if (!v9fs_proto_dotu(v9ses)) { |
5d385153 | 1194 | p9_debug(P9_DEBUG_ERROR, "not extended\n"); |
6a3124a3 | 1195 | return -EPERM; |
2bad8471 EVH |
1196 | } |
1197 | ||
bd238fb4 LI |
1198 | fid = v9fs_create(v9ses, dir, dentry, (char *) extension, perm, |
1199 | P9_OREAD); | |
1200 | if (IS_ERR(fid)) | |
1201 | return PTR_ERR(fid); | |
da977b2c | 1202 | |
d28c61f0 | 1203 | v9fs_invalidate_inode_attr(dir); |
b48dbb99 | 1204 | p9_fid_put(fid); |
6a3124a3 | 1205 | return 0; |
531b1094 LI |
1206 | } |
1207 | ||
1208 | /** | |
1209 | * v9fs_vfs_symlink - helper function to create symlinks | |
7a77db95 | 1210 | * @idmap: idmap of the mount |
531b1094 LI |
1211 | * @dir: directory inode containing symlink |
1212 | * @dentry: dentry for symlink | |
1213 | * @symname: symlink data | |
1214 | * | |
ee443996 | 1215 | * See Also: 9P2000.u RFC for more information |
531b1094 LI |
1216 | * |
1217 | */ | |
1218 | ||
1219 | static int | |
7a77db95 | 1220 | v9fs_vfs_symlink(struct mnt_idmap *idmap, struct inode *dir, |
549c7297 | 1221 | struct dentry *dentry, const char *symname) |
531b1094 | 1222 | { |
4b8e9923 AV |
1223 | p9_debug(P9_DEBUG_VFS, " %lu,%pd,%s\n", |
1224 | dir->i_ino, dentry, symname); | |
531b1094 | 1225 | |
c2837de7 | 1226 | return v9fs_vfs_mkspecial(dir, dentry, P9_DMSYMLINK, symname); |
531b1094 LI |
1227 | } |
1228 | ||
b46c267e AV |
1229 | #define U32_MAX_DIGITS 10 |
1230 | ||
531b1094 LI |
1231 | /** |
1232 | * v9fs_vfs_link - create a hardlink | |
1233 | * @old_dentry: dentry for file to link to | |
1234 | * @dir: inode destination for new link | |
1235 | * @dentry: dentry for link | |
1236 | * | |
1237 | */ | |
1238 | ||
531b1094 LI |
1239 | static int |
1240 | v9fs_vfs_link(struct dentry *old_dentry, struct inode *dir, | |
1241 | struct dentry *dentry) | |
1242 | { | |
1243 | int retval; | |
b46c267e | 1244 | char name[1 + U32_MAX_DIGITS + 2]; /* sign + number + \n + \0 */ |
d28c61f0 | 1245 | struct p9_fid *oldfid; |
531b1094 | 1246 | |
4b8e9923 AV |
1247 | p9_debug(P9_DEBUG_VFS, " %lu,%pd,%pd\n", |
1248 | dir->i_ino, dentry, old_dentry); | |
531b1094 | 1249 | |
da977b2c | 1250 | oldfid = v9fs_fid_clone(old_dentry); |
ba17674f | 1251 | if (IS_ERR(oldfid)) |
da977b2c | 1252 | return PTR_ERR(oldfid); |
531b1094 | 1253 | |
16cce6d2 | 1254 | sprintf(name, "%d\n", oldfid->fid); |
bd238fb4 | 1255 | retval = v9fs_vfs_mkspecial(dir, dentry, P9_DMLINK, name); |
c06c066a | 1256 | if (!retval) { |
2b0143b5 | 1257 | v9fs_refresh_inode(oldfid, d_inode(old_dentry)); |
d28c61f0 | 1258 | v9fs_invalidate_inode_attr(dir); |
c06c066a | 1259 | } |
b48dbb99 | 1260 | p9_fid_put(oldfid); |
2bad8471 EVH |
1261 | return retval; |
1262 | } | |
1263 | ||
1264 | /** | |
1265 | * v9fs_vfs_mknod - create a special file | |
5ebb29be | 1266 | * @idmap: idmap of the mount |
2bad8471 EVH |
1267 | * @dir: inode destination for new link |
1268 | * @dentry: dentry for file | |
1269 | * @mode: mode for creation | |
ee443996 | 1270 | * @rdev: device associated with special file |
2bad8471 EVH |
1271 | * |
1272 | */ | |
1273 | ||
1274 | static int | |
5ebb29be | 1275 | v9fs_vfs_mknod(struct mnt_idmap *idmap, struct inode *dir, |
549c7297 | 1276 | struct dentry *dentry, umode_t mode, dev_t rdev) |
2bad8471 | 1277 | { |
c2837de7 | 1278 | struct v9fs_session_info *v9ses = v9fs_inode2v9ses(dir); |
531b1094 | 1279 | int retval; |
b46c267e | 1280 | char name[2 + U32_MAX_DIGITS + 1 + U32_MAX_DIGITS + 1]; |
c2837de7 | 1281 | u32 perm; |
2bad8471 | 1282 | |
6e195b0f | 1283 | p9_debug(P9_DEBUG_VFS, " %lu,%pd mode: %x MAJOR: %u MINOR: %u\n", |
4b8e9923 | 1284 | dir->i_ino, dentry, mode, |
5d385153 | 1285 | MAJOR(rdev), MINOR(rdev)); |
2bad8471 | 1286 | |
2bad8471 EVH |
1287 | /* build extension */ |
1288 | if (S_ISBLK(mode)) | |
531b1094 | 1289 | sprintf(name, "b %u %u", MAJOR(rdev), MINOR(rdev)); |
2bad8471 | 1290 | else if (S_ISCHR(mode)) |
531b1094 | 1291 | sprintf(name, "c %u %u", MAJOR(rdev), MINOR(rdev)); |
b46c267e | 1292 | else |
75cc5c9b | 1293 | *name = 0; |
2bad8471 | 1294 | |
c2837de7 AV |
1295 | perm = unixmode2p9mode(v9ses, mode); |
1296 | retval = v9fs_vfs_mkspecial(dir, dentry, perm, name); | |
2bad8471 EVH |
1297 | |
1298 | return retval; | |
1299 | } | |
1300 | ||
b3cbea03 AK |
1301 | int v9fs_refresh_inode(struct p9_fid *fid, struct inode *inode) |
1302 | { | |
45089142 AK |
1303 | int umode; |
1304 | dev_t rdev; | |
b3cbea03 AK |
1305 | struct p9_wstat *st; |
1306 | struct v9fs_session_info *v9ses; | |
5e3cc1ee | 1307 | unsigned int flags; |
b3cbea03 AK |
1308 | |
1309 | v9ses = v9fs_inode2v9ses(inode); | |
1310 | st = p9_client_stat(fid); | |
1311 | if (IS_ERR(st)) | |
1312 | return PTR_ERR(st); | |
45089142 AK |
1313 | /* |
1314 | * Don't update inode if the file type is different | |
1315 | */ | |
1316 | umode = p9mode2unixmode(v9ses, st, &rdev); | |
6e3e2c43 | 1317 | if (inode_wrong_type(inode, umode)) |
45089142 | 1318 | goto out; |
b3cbea03 | 1319 | |
b3cbea03 AK |
1320 | /* |
1321 | * We don't want to refresh inode->i_size, | |
1322 | * because we may have cached data | |
1323 | */ | |
4eb31178 | 1324 | flags = (v9ses->cache & CACHE_LOOSE) ? |
5e3cc1ee HT |
1325 | V9FS_STAT2INODE_KEEP_ISIZE : 0; |
1326 | v9fs_stat2inode(st, inode, inode->i_sb, flags); | |
45089142 | 1327 | out: |
b3cbea03 AK |
1328 | p9stat_free(st); |
1329 | kfree(st); | |
1330 | return 0; | |
1331 | } | |
1332 | ||
9b6533c9 SK |
1333 | static const struct inode_operations v9fs_dir_inode_operations_dotu = { |
1334 | .create = v9fs_vfs_create, | |
1335 | .lookup = v9fs_vfs_lookup, | |
e43ae79c | 1336 | .atomic_open = v9fs_vfs_atomic_open, |
9b6533c9 | 1337 | .symlink = v9fs_vfs_symlink, |
50cc42ff | 1338 | .link = v9fs_vfs_link, |
9b6533c9 SK |
1339 | .unlink = v9fs_vfs_unlink, |
1340 | .mkdir = v9fs_vfs_mkdir, | |
1341 | .rmdir = v9fs_vfs_rmdir, | |
1d76e313 | 1342 | .mknod = v9fs_vfs_mknod, |
9b6533c9 SK |
1343 | .rename = v9fs_vfs_rename, |
1344 | .getattr = v9fs_vfs_getattr, | |
1345 | .setattr = v9fs_vfs_setattr, | |
1346 | }; | |
1347 | ||
754661f1 | 1348 | static const struct inode_operations v9fs_dir_inode_operations = { |
b501611a EVH |
1349 | .create = v9fs_vfs_create, |
1350 | .lookup = v9fs_vfs_lookup, | |
e43ae79c | 1351 | .atomic_open = v9fs_vfs_atomic_open, |
b501611a EVH |
1352 | .unlink = v9fs_vfs_unlink, |
1353 | .mkdir = v9fs_vfs_mkdir, | |
1354 | .rmdir = v9fs_vfs_rmdir, | |
1355 | .mknod = v9fs_vfs_mknod, | |
1356 | .rename = v9fs_vfs_rename, | |
1357 | .getattr = v9fs_vfs_getattr, | |
1358 | .setattr = v9fs_vfs_setattr, | |
1359 | }; | |
1360 | ||
754661f1 | 1361 | static const struct inode_operations v9fs_file_inode_operations = { |
2bad8471 EVH |
1362 | .getattr = v9fs_vfs_getattr, |
1363 | .setattr = v9fs_vfs_setattr, | |
1364 | }; | |
1365 | ||
754661f1 | 1366 | static const struct inode_operations v9fs_symlink_inode_operations = { |
6b255391 | 1367 | .get_link = v9fs_vfs_get_link, |
2bad8471 EVH |
1368 | .getattr = v9fs_vfs_getattr, |
1369 | .setattr = v9fs_vfs_setattr, | |
1370 | }; | |
9b6533c9 | 1371 |