1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* -*- mode: c; c-basic-offset: 8; -*-
3 * vim: noexpandtab sw=8 ts=8 sts=0:
7 * Code which implements the kernel side of a minimal userspace
8 * interface to our DLM. This file handles the virtual file system
9 * used for communication with userspace. Credit should go to ramfs,
10 * which was a template for the fs side of this module.
12 * Copyright (C) 2003, 2004 Oracle. All rights reserved.
15 /* Simple VFS hooks based on: */
17 * Resizable simple ram filesystem for Linux.
19 * Copyright (C) 2000 Linus Torvalds.
20 * 2000 Transmeta Corp.
23 #include <linux/module.h>
25 #include <linux/pagemap.h>
26 #include <linux/types.h>
27 #include <linux/slab.h>
28 #include <linux/highmem.h>
29 #include <linux/init.h>
30 #include <linux/string.h>
31 #include <linux/backing-dev.h>
32 #include <linux/poll.h>
34 #include <linux/uaccess.h>
36 #include "../stackglue.h"
39 #define MLOG_MASK_PREFIX ML_DLMFS
40 #include "../cluster/masklog.h"
43 static const struct super_operations dlmfs_ops
;
44 static const struct file_operations dlmfs_file_operations
;
45 static const struct inode_operations dlmfs_dir_inode_operations
;
46 static const struct inode_operations dlmfs_root_inode_operations
;
47 static const struct inode_operations dlmfs_file_inode_operations
;
48 static struct kmem_cache
*dlmfs_inode_cache
;
50 struct workqueue_struct
*user_dlm_worker
;
55 * These are the ABI capabilities of dlmfs.
57 * Over time, dlmfs has added some features that were not part of the
58 * initial ABI. Unfortunately, some of these features are not detectable
59 * via standard usage. For example, Linux's default poll always returns
60 * EPOLLIN, so there is no way for a caller of poll(2) to know when dlmfs
61 * added poll support. Instead, we provide this list of new capabilities.
63 * Capabilities is a read-only attribute. We do it as a module parameter
64 * so we can discover it whether dlmfs is built in, loaded, or even not
67 * The ABI features are local to this machine's dlmfs mount. This is
68 * distinct from the locking protocol, which is concerned with inter-node
72 * - bast : EPOLLIN against the file descriptor of a held lock
73 * signifies a bast fired on the lock.
75 #define DLMFS_CAPABILITIES "bast stackglue"
76 static int param_set_dlmfs_capabilities(const char *val
,
77 const struct kernel_param
*kp
)
79 printk(KERN_ERR
"%s: readonly parameter\n", kp
->name
);
82 static int param_get_dlmfs_capabilities(char *buffer
,
83 const struct kernel_param
*kp
)
85 return strlcpy(buffer
, DLMFS_CAPABILITIES
,
86 strlen(DLMFS_CAPABILITIES
) + 1);
88 module_param_call(capabilities
, param_set_dlmfs_capabilities
,
89 param_get_dlmfs_capabilities
, NULL
, 0444);
90 MODULE_PARM_DESC(capabilities
, DLMFS_CAPABILITIES
);
94 * decodes a set of open flags into a valid lock level and a set of flags.
95 * returns < 0 if we have invalid flags
96 * flags which mean something to us:
97 * O_RDONLY -> PRMODE level
98 * O_WRONLY -> EXMODE level
100 * O_NONBLOCK -> NOQUEUE
102 static int dlmfs_decode_open_flags(int open_flags
,
106 if (open_flags
& (O_WRONLY
|O_RDWR
))
107 *level
= DLM_LOCK_EX
;
109 *level
= DLM_LOCK_PR
;
112 if (open_flags
& O_NONBLOCK
)
113 *flags
|= DLM_LKF_NOQUEUE
;
118 static int dlmfs_file_open(struct inode
*inode
,
121 int status
, level
, flags
;
122 struct dlmfs_filp_private
*fp
= NULL
;
123 struct dlmfs_inode_private
*ip
;
125 if (S_ISDIR(inode
->i_mode
))
128 mlog(0, "open called on inode %lu, flags 0x%x\n", inode
->i_ino
,
131 status
= dlmfs_decode_open_flags(file
->f_flags
, &level
, &flags
);
135 /* We don't want to honor O_APPEND at read/write time as it
136 * doesn't make sense for LVB writes. */
137 file
->f_flags
&= ~O_APPEND
;
139 fp
= kmalloc(sizeof(*fp
), GFP_NOFS
);
144 fp
->fp_lock_level
= level
;
148 status
= user_dlm_cluster_lock(&ip
->ip_lockres
, level
, flags
);
150 /* this is a strange error to return here but I want
151 * to be able userspace to be able to distinguish a
152 * valid lock request from one that simply couldn't be
154 if (flags
& DLM_LKF_NOQUEUE
&& status
== -EAGAIN
)
160 file
->private_data
= fp
;
165 static int dlmfs_file_release(struct inode
*inode
,
169 struct dlmfs_inode_private
*ip
= DLMFS_I(inode
);
170 struct dlmfs_filp_private
*fp
= file
->private_data
;
172 if (S_ISDIR(inode
->i_mode
))
175 mlog(0, "close called on inode %lu\n", inode
->i_ino
);
178 level
= fp
->fp_lock_level
;
179 if (level
!= DLM_LOCK_IV
)
180 user_dlm_cluster_unlock(&ip
->ip_lockres
, level
);
183 file
->private_data
= NULL
;
190 * We do ->setattr() just to override size changes. Our size is the size
191 * of the LVB and nothing else.
193 static int dlmfs_file_setattr(struct dentry
*dentry
, struct iattr
*attr
)
196 struct inode
*inode
= d_inode(dentry
);
198 attr
->ia_valid
&= ~ATTR_SIZE
;
199 error
= setattr_prepare(dentry
, attr
);
203 setattr_copy(inode
, attr
);
204 mark_inode_dirty(inode
);
208 static __poll_t
dlmfs_file_poll(struct file
*file
, poll_table
*wait
)
211 struct inode
*inode
= file_inode(file
);
212 struct dlmfs_inode_private
*ip
= DLMFS_I(inode
);
214 poll_wait(file
, &ip
->ip_lockres
.l_event
, wait
);
216 spin_lock(&ip
->ip_lockres
.l_lock
);
217 if (ip
->ip_lockres
.l_flags
& USER_LOCK_BLOCKED
)
218 event
= EPOLLIN
| EPOLLRDNORM
;
219 spin_unlock(&ip
->ip_lockres
.l_lock
);
224 static ssize_t
dlmfs_file_read(struct file
*filp
,
230 ssize_t readlen
, got
;
232 struct inode
*inode
= file_inode(filp
);
234 mlog(0, "inode %lu, count = %zu, *ppos = %llu\n",
235 inode
->i_ino
, count
, *ppos
);
237 if (*ppos
>= i_size_read(inode
))
243 if (!access_ok(buf
, count
))
246 /* don't read past the lvb */
247 if ((count
+ *ppos
) > i_size_read(inode
))
248 readlen
= i_size_read(inode
) - *ppos
;
252 lvb_buf
= kmalloc(readlen
, GFP_NOFS
);
256 got
= user_dlm_read_lvb(inode
, lvb_buf
, readlen
);
258 BUG_ON(got
!= readlen
);
259 bytes_left
= __copy_to_user(buf
, lvb_buf
, readlen
);
260 readlen
-= bytes_left
;
266 *ppos
= *ppos
+ readlen
;
268 mlog(0, "read %zd bytes\n", readlen
);
272 static ssize_t
dlmfs_file_write(struct file
*filp
,
273 const char __user
*buf
,
280 struct inode
*inode
= file_inode(filp
);
282 mlog(0, "inode %lu, count = %zu, *ppos = %llu\n",
283 inode
->i_ino
, count
, *ppos
);
285 if (*ppos
>= i_size_read(inode
))
291 if (!access_ok(buf
, count
))
294 /* don't write past the lvb */
295 if ((count
+ *ppos
) > i_size_read(inode
))
296 writelen
= i_size_read(inode
) - *ppos
;
298 writelen
= count
- *ppos
;
300 lvb_buf
= kmalloc(writelen
, GFP_NOFS
);
304 bytes_left
= copy_from_user(lvb_buf
, buf
, writelen
);
305 writelen
-= bytes_left
;
307 user_dlm_write_lvb(inode
, lvb_buf
, writelen
);
311 *ppos
= *ppos
+ writelen
;
312 mlog(0, "wrote %zd bytes\n", writelen
);
316 static void dlmfs_init_once(void *foo
)
318 struct dlmfs_inode_private
*ip
=
319 (struct dlmfs_inode_private
*) foo
;
322 ip
->ip_parent
= NULL
;
324 inode_init_once(&ip
->ip_vfs_inode
);
327 static struct inode
*dlmfs_alloc_inode(struct super_block
*sb
)
329 struct dlmfs_inode_private
*ip
;
331 ip
= kmem_cache_alloc(dlmfs_inode_cache
, GFP_NOFS
);
335 return &ip
->ip_vfs_inode
;
338 static void dlmfs_free_inode(struct inode
*inode
)
340 kmem_cache_free(dlmfs_inode_cache
, DLMFS_I(inode
));
343 static void dlmfs_evict_inode(struct inode
*inode
)
346 struct dlmfs_inode_private
*ip
;
350 mlog(0, "inode %lu\n", inode
->i_ino
);
354 if (S_ISREG(inode
->i_mode
)) {
355 status
= user_dlm_destroy_lock(&ip
->ip_lockres
);
362 mlog(0, "we're a directory, ip->ip_conn = 0x%p\n", ip
->ip_conn
);
363 /* we must be a directory. If required, lets unregister the
364 * dlm context now. */
366 user_dlm_unregister(ip
->ip_conn
);
368 ip
->ip_parent
= NULL
;
372 static struct inode
*dlmfs_get_root_inode(struct super_block
*sb
)
374 struct inode
*inode
= new_inode(sb
);
375 umode_t mode
= S_IFDIR
| 0755;
378 inode
->i_ino
= get_next_ino();
379 inode_init_owner(inode
, NULL
, mode
);
380 inode
->i_atime
= inode
->i_mtime
= inode
->i_ctime
= current_time(inode
);
383 inode
->i_fop
= &simple_dir_operations
;
384 inode
->i_op
= &dlmfs_root_inode_operations
;
390 static struct inode
*dlmfs_get_inode(struct inode
*parent
,
391 struct dentry
*dentry
,
394 struct super_block
*sb
= parent
->i_sb
;
395 struct inode
* inode
= new_inode(sb
);
396 struct dlmfs_inode_private
*ip
;
401 inode
->i_ino
= get_next_ino();
402 inode_init_owner(inode
, parent
, mode
);
403 inode
->i_atime
= inode
->i_mtime
= inode
->i_ctime
= current_time(inode
);
406 ip
->ip_conn
= DLMFS_I(parent
)->ip_conn
;
408 switch (mode
& S_IFMT
) {
410 /* for now we don't support anything other than
411 * directories and regular files. */
415 inode
->i_op
= &dlmfs_file_inode_operations
;
416 inode
->i_fop
= &dlmfs_file_operations
;
418 i_size_write(inode
, DLM_LVB_LEN
);
420 user_dlm_lock_res_init(&ip
->ip_lockres
, dentry
);
422 /* released at clear_inode time, this insures that we
423 * get to drop the dlm reference on each lock *before*
424 * we call the unregister code for releasing parent
426 ip
->ip_parent
= igrab(parent
);
427 BUG_ON(!ip
->ip_parent
);
430 inode
->i_op
= &dlmfs_dir_inode_operations
;
431 inode
->i_fop
= &simple_dir_operations
;
433 /* directory inodes start off with i_nlink ==
434 * 2 (for "." entry) */
442 * File creation. Allocate an inode, and we're done..
445 static int dlmfs_mkdir(struct inode
* dir
,
446 struct dentry
* dentry
,
450 struct inode
*inode
= NULL
;
451 const struct qstr
*domain
= &dentry
->d_name
;
452 struct dlmfs_inode_private
*ip
;
453 struct ocfs2_cluster_connection
*conn
;
455 mlog(0, "mkdir %.*s\n", domain
->len
, domain
->name
);
457 /* verify that we have a proper domain */
458 if (domain
->len
>= GROUP_NAME_MAX
) {
460 mlog(ML_ERROR
, "invalid domain name for directory.\n");
464 inode
= dlmfs_get_inode(dir
, dentry
, mode
| S_IFDIR
);
473 conn
= user_dlm_register(domain
);
475 status
= PTR_ERR(conn
);
476 mlog(ML_ERROR
, "Error %d could not register domain \"%.*s\"\n",
477 status
, domain
->len
, domain
->name
);
483 d_instantiate(dentry
, inode
);
484 dget(dentry
); /* Extra count - pin the dentry in core */
493 static int dlmfs_create(struct inode
*dir
,
494 struct dentry
*dentry
,
500 const struct qstr
*name
= &dentry
->d_name
;
502 mlog(0, "create %.*s\n", name
->len
, name
->name
);
504 /* verify name is valid and doesn't contain any dlm reserved
506 if (name
->len
>= USER_DLM_LOCK_ID_MAX_LEN
||
507 name
->name
[0] == '$') {
509 mlog(ML_ERROR
, "invalid lock name, %.*s\n", name
->len
,
514 inode
= dlmfs_get_inode(dir
, dentry
, mode
| S_IFREG
);
521 d_instantiate(dentry
, inode
);
522 dget(dentry
); /* Extra count - pin the dentry in core */
527 static int dlmfs_unlink(struct inode
*dir
,
528 struct dentry
*dentry
)
531 struct inode
*inode
= d_inode(dentry
);
533 mlog(0, "unlink inode %lu\n", inode
->i_ino
);
535 /* if there are no current holders, or none that are waiting
536 * to acquire a lock, this basically destroys our lockres. */
537 status
= user_dlm_destroy_lock(&DLMFS_I(inode
)->ip_lockres
);
539 mlog(ML_ERROR
, "unlink %pd, error %d from destroy\n",
543 status
= simple_unlink(dir
, dentry
);
548 static int dlmfs_fill_super(struct super_block
* sb
,
552 sb
->s_maxbytes
= MAX_LFS_FILESIZE
;
553 sb
->s_blocksize
= PAGE_SIZE
;
554 sb
->s_blocksize_bits
= PAGE_SHIFT
;
555 sb
->s_magic
= DLMFS_MAGIC
;
556 sb
->s_op
= &dlmfs_ops
;
557 sb
->s_root
= d_make_root(dlmfs_get_root_inode(sb
));
563 static const struct file_operations dlmfs_file_operations
= {
564 .open
= dlmfs_file_open
,
565 .release
= dlmfs_file_release
,
566 .poll
= dlmfs_file_poll
,
567 .read
= dlmfs_file_read
,
568 .write
= dlmfs_file_write
,
569 .llseek
= default_llseek
,
572 static const struct inode_operations dlmfs_dir_inode_operations
= {
573 .create
= dlmfs_create
,
574 .lookup
= simple_lookup
,
575 .unlink
= dlmfs_unlink
,
578 /* this way we can restrict mkdir to only the toplevel of the fs. */
579 static const struct inode_operations dlmfs_root_inode_operations
= {
580 .lookup
= simple_lookup
,
581 .mkdir
= dlmfs_mkdir
,
582 .rmdir
= simple_rmdir
,
585 static const struct super_operations dlmfs_ops
= {
586 .statfs
= simple_statfs
,
587 .alloc_inode
= dlmfs_alloc_inode
,
588 .free_inode
= dlmfs_free_inode
,
589 .evict_inode
= dlmfs_evict_inode
,
590 .drop_inode
= generic_delete_inode
,
593 static const struct inode_operations dlmfs_file_inode_operations
= {
594 .getattr
= simple_getattr
,
595 .setattr
= dlmfs_file_setattr
,
598 static struct dentry
*dlmfs_mount(struct file_system_type
*fs_type
,
599 int flags
, const char *dev_name
, void *data
)
601 return mount_nodev(fs_type
, flags
, data
, dlmfs_fill_super
);
604 static struct file_system_type dlmfs_fs_type
= {
605 .owner
= THIS_MODULE
,
606 .name
= "ocfs2_dlmfs",
607 .mount
= dlmfs_mount
,
608 .kill_sb
= kill_litter_super
,
610 MODULE_ALIAS_FS("ocfs2_dlmfs");
612 static int __init
init_dlmfs_fs(void)
615 int cleanup_inode
= 0, cleanup_worker
= 0;
617 dlmfs_inode_cache
= kmem_cache_create("dlmfs_inode_cache",
618 sizeof(struct dlmfs_inode_private
),
619 0, (SLAB_HWCACHE_ALIGN
|SLAB_RECLAIM_ACCOUNT
|
620 SLAB_MEM_SPREAD
|SLAB_ACCOUNT
),
622 if (!dlmfs_inode_cache
) {
628 user_dlm_worker
= alloc_workqueue("user_dlm", WQ_MEM_RECLAIM
, 0);
629 if (!user_dlm_worker
) {
635 user_dlm_set_locking_protocol();
636 status
= register_filesystem(&dlmfs_fs_type
);
640 kmem_cache_destroy(dlmfs_inode_cache
);
642 destroy_workqueue(user_dlm_worker
);
644 printk("OCFS2 User DLM kernel interface loaded\n");
648 static void __exit
exit_dlmfs_fs(void)
650 unregister_filesystem(&dlmfs_fs_type
);
652 destroy_workqueue(user_dlm_worker
);
655 * Make sure all delayed rcu free inodes are flushed before we
659 kmem_cache_destroy(dlmfs_inode_cache
);
663 MODULE_AUTHOR("Oracle");
664 MODULE_LICENSE("GPL");
665 MODULE_DESCRIPTION("OCFS2 DLM-Filesystem");
667 module_init(init_dlmfs_fs
)
668 module_exit(exit_dlmfs_fs
)