1 // SPDX-License-Identifier: GPL-1.0+
3 * Hypervisor filesystem for Linux on s390.
5 * Copyright IBM Corp. 2006, 2008
6 * Author(s): Michael Holzheu <holzheu@de.ibm.com>
9 #define KMSG_COMPONENT "hypfs"
10 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
12 #include <linux/types.h>
13 #include <linux/errno.h>
15 #include <linux/namei.h>
16 #include <linux/vfs.h>
17 #include <linux/slab.h>
18 #include <linux/pagemap.h>
19 #include <linux/time.h>
20 #include <linux/parser.h>
21 #include <linux/sysfs.h>
22 #include <linux/init.h>
23 #include <linux/kobject.h>
24 #include <linux/seq_file.h>
25 #include <linux/mount.h>
26 #include <linux/uio.h>
27 #include <asm/ebcdic.h>
30 #define HYPFS_MAGIC 0x687970 /* ASCII 'hyp' */
31 #define TMP_SIZE 64 /* size of temporary buffers */
33 static struct dentry *hypfs_create_update_file(struct dentry *dir);
35 struct hypfs_sb_info {
36 kuid_t uid; /* uid used for files and dirs */
37 kgid_t gid; /* gid used for files and dirs */
38 struct dentry *update_file; /* file to trigger update */
39 time64_t last_update; /* last update, CLOCK_MONOTONIC time */
40 struct mutex lock; /* lock to protect update process */
43 static const struct file_operations hypfs_file_ops;
44 static struct file_system_type hypfs_type;
45 static const struct super_operations hypfs_s_ops;
47 /* start of list of all dentries, which have to be deleted on update */
48 static struct dentry *hypfs_last_dentry;
50 static void hypfs_update_update(struct super_block *sb)
52 struct hypfs_sb_info *sb_info = sb->s_fs_info;
53 struct inode *inode = d_inode(sb_info->update_file);
55 sb_info->last_update = ktime_get_seconds();
56 inode->i_atime = inode->i_mtime = inode->i_ctime = current_time(inode);
59 /* directory tree removal functions */
61 static void hypfs_add_dentry(struct dentry *dentry)
63 dentry->d_fsdata = hypfs_last_dentry;
64 hypfs_last_dentry = dentry;
67 static void hypfs_remove(struct dentry *dentry)
69 struct dentry *parent;
71 parent = dentry->d_parent;
72 inode_lock(d_inode(parent));
73 if (simple_positive(dentry)) {
75 simple_rmdir(d_inode(parent), dentry);
77 simple_unlink(d_inode(parent), dentry);
81 inode_unlock(d_inode(parent));
84 static void hypfs_delete_tree(struct dentry *root)
86 while (hypfs_last_dentry) {
87 struct dentry *next_dentry;
88 next_dentry = hypfs_last_dentry->d_fsdata;
89 hypfs_remove(hypfs_last_dentry);
90 hypfs_last_dentry = next_dentry;
94 static struct inode *hypfs_make_inode(struct super_block *sb, umode_t mode)
96 struct inode *ret = new_inode(sb);
99 struct hypfs_sb_info *hypfs_info = sb->s_fs_info;
100 ret->i_ino = get_next_ino();
102 ret->i_uid = hypfs_info->uid;
103 ret->i_gid = hypfs_info->gid;
104 ret->i_atime = ret->i_mtime = ret->i_ctime = current_time(ret);
111 static void hypfs_evict_inode(struct inode *inode)
114 kfree(inode->i_private);
117 static int hypfs_open(struct inode *inode, struct file *filp)
119 char *data = file_inode(filp)->i_private;
120 struct hypfs_sb_info *fs_info;
122 if (filp->f_mode & FMODE_WRITE) {
123 if (!(inode->i_mode & S_IWUGO))
126 if (filp->f_mode & FMODE_READ) {
127 if (!(inode->i_mode & S_IRUGO))
131 fs_info = inode->i_sb->s_fs_info;
133 mutex_lock(&fs_info->lock);
134 filp->private_data = kstrdup(data, GFP_KERNEL);
135 if (!filp->private_data) {
136 mutex_unlock(&fs_info->lock);
139 mutex_unlock(&fs_info->lock);
141 return nonseekable_open(inode, filp);
144 static ssize_t hypfs_read_iter(struct kiocb *iocb, struct iov_iter *to)
146 struct file *file = iocb->ki_filp;
147 char *data = file->private_data;
148 size_t available = strlen(data);
149 loff_t pos = iocb->ki_pos;
154 if (pos >= available || !iov_iter_count(to))
156 count = copy_to_iter(data + pos, available - pos, to);
159 iocb->ki_pos = pos + count;
164 static ssize_t hypfs_write_iter(struct kiocb *iocb, struct iov_iter *from)
167 struct super_block *sb = file_inode(iocb->ki_filp)->i_sb;
168 struct hypfs_sb_info *fs_info = sb->s_fs_info;
169 size_t count = iov_iter_count(from);
172 * Currently we only allow one update per second for two reasons:
173 * 1. diag 204 is VERY expensive
174 * 2. If several processes do updates in parallel and then read the
175 * hypfs data, the likelihood of collisions is reduced, if we restrict
176 * the minimum update interval. A collision occurs, if during the
177 * data gathering of one process another process triggers an update
178 * If the first process wants to ensure consistent data, it has
179 * to restart data collection in this case.
181 mutex_lock(&fs_info->lock);
182 if (fs_info->last_update == ktime_get_seconds()) {
186 hypfs_delete_tree(sb->s_root);
188 rc = hypfs_vm_create_files(sb->s_root);
190 rc = hypfs_diag_create_files(sb->s_root);
192 pr_err("Updating the hypfs tree failed\n");
193 hypfs_delete_tree(sb->s_root);
196 hypfs_update_update(sb);
198 iov_iter_advance(from, count);
200 mutex_unlock(&fs_info->lock);
204 static int hypfs_release(struct inode *inode, struct file *filp)
206 kfree(filp->private_data);
210 enum { opt_uid, opt_gid, opt_err };
212 static const match_table_t hypfs_tokens = {
218 static int hypfs_parse_options(char *options, struct super_block *sb)
221 substring_t args[MAX_OPT_ARGS];
227 while ((str = strsep(&options, ",")) != NULL) {
229 struct hypfs_sb_info *hypfs_info = sb->s_fs_info;
233 token = match_token(str, hypfs_tokens, args);
236 if (match_int(&args[0], &option))
238 uid = make_kuid(current_user_ns(), option);
241 hypfs_info->uid = uid;
244 if (match_int(&args[0], &option))
246 gid = make_kgid(current_user_ns(), option);
249 hypfs_info->gid = gid;
253 pr_err("%s is not a valid mount option\n", str);
260 static int hypfs_show_options(struct seq_file *s, struct dentry *root)
262 struct hypfs_sb_info *hypfs_info = root->d_sb->s_fs_info;
264 seq_printf(s, ",uid=%u", from_kuid_munged(&init_user_ns, hypfs_info->uid));
265 seq_printf(s, ",gid=%u", from_kgid_munged(&init_user_ns, hypfs_info->gid));
269 static int hypfs_fill_super(struct super_block *sb, void *data, int silent)
271 struct inode *root_inode;
272 struct dentry *root_dentry, *update_file;
274 struct hypfs_sb_info *sbi;
276 sbi = kzalloc(sizeof(struct hypfs_sb_info), GFP_KERNEL);
279 mutex_init(&sbi->lock);
280 sbi->uid = current_uid();
281 sbi->gid = current_gid();
283 sb->s_blocksize = PAGE_SIZE;
284 sb->s_blocksize_bits = PAGE_SHIFT;
285 sb->s_magic = HYPFS_MAGIC;
286 sb->s_op = &hypfs_s_ops;
287 if (hypfs_parse_options(data, sb))
289 root_inode = hypfs_make_inode(sb, S_IFDIR | 0755);
292 root_inode->i_op = &simple_dir_inode_operations;
293 root_inode->i_fop = &simple_dir_operations;
294 sb->s_root = root_dentry = d_make_root(root_inode);
298 rc = hypfs_vm_create_files(root_dentry);
300 rc = hypfs_diag_create_files(root_dentry);
303 update_file = hypfs_create_update_file(root_dentry);
304 if (IS_ERR(update_file))
305 return PTR_ERR(update_file);
306 sbi->update_file = update_file;
307 hypfs_update_update(sb);
308 pr_info("Hypervisor filesystem mounted\n");
312 static struct dentry *hypfs_mount(struct file_system_type *fst, int flags,
313 const char *devname, void *data)
315 return mount_single(fst, flags, data, hypfs_fill_super);
318 static void hypfs_kill_super(struct super_block *sb)
320 struct hypfs_sb_info *sb_info = sb->s_fs_info;
323 hypfs_delete_tree(sb->s_root);
324 if (sb_info && sb_info->update_file)
325 hypfs_remove(sb_info->update_file);
326 kfree(sb->s_fs_info);
327 sb->s_fs_info = NULL;
328 kill_litter_super(sb);
331 static struct dentry *hypfs_create_file(struct dentry *parent, const char *name,
332 char *data, umode_t mode)
334 struct dentry *dentry;
337 inode_lock(d_inode(parent));
338 dentry = lookup_one_len(name, parent, strlen(name));
339 if (IS_ERR(dentry)) {
340 dentry = ERR_PTR(-ENOMEM);
343 inode = hypfs_make_inode(parent->d_sb, mode);
346 dentry = ERR_PTR(-ENOMEM);
350 inode->i_fop = &hypfs_file_ops;
352 inode->i_size = strlen(data);
355 } else if (S_ISDIR(mode)) {
356 inode->i_op = &simple_dir_inode_operations;
357 inode->i_fop = &simple_dir_operations;
358 inc_nlink(d_inode(parent));
361 inode->i_private = data;
362 d_instantiate(dentry, inode);
365 inode_unlock(d_inode(parent));
369 struct dentry *hypfs_mkdir(struct dentry *parent, const char *name)
371 struct dentry *dentry;
373 dentry = hypfs_create_file(parent, name, NULL, S_IFDIR | DIR_MODE);
376 hypfs_add_dentry(dentry);
380 static struct dentry *hypfs_create_update_file(struct dentry *dir)
382 struct dentry *dentry;
384 dentry = hypfs_create_file(dir, "update", NULL,
385 S_IFREG | UPDATE_FILE_MODE);
387 * We do not put the update file on the 'delete' list with
388 * hypfs_add_dentry(), since it should not be removed when the tree
394 struct dentry *hypfs_create_u64(struct dentry *dir,
395 const char *name, __u64 value)
399 struct dentry *dentry;
401 snprintf(tmp, TMP_SIZE, "%llu\n", (unsigned long long int)value);
402 buffer = kstrdup(tmp, GFP_KERNEL);
404 return ERR_PTR(-ENOMEM);
406 hypfs_create_file(dir, name, buffer, S_IFREG | REG_FILE_MODE);
407 if (IS_ERR(dentry)) {
409 return ERR_PTR(-ENOMEM);
411 hypfs_add_dentry(dentry);
415 struct dentry *hypfs_create_str(struct dentry *dir,
416 const char *name, char *string)
419 struct dentry *dentry;
421 buffer = kmalloc(strlen(string) + 2, GFP_KERNEL);
423 return ERR_PTR(-ENOMEM);
424 sprintf(buffer, "%s\n", string);
426 hypfs_create_file(dir, name, buffer, S_IFREG | REG_FILE_MODE);
427 if (IS_ERR(dentry)) {
429 return ERR_PTR(-ENOMEM);
431 hypfs_add_dentry(dentry);
435 static const struct file_operations hypfs_file_ops = {
437 .release = hypfs_release,
438 .read_iter = hypfs_read_iter,
439 .write_iter = hypfs_write_iter,
443 static struct file_system_type hypfs_type = {
444 .owner = THIS_MODULE,
445 .name = "s390_hypfs",
446 .mount = hypfs_mount,
447 .kill_sb = hypfs_kill_super
450 static const struct super_operations hypfs_s_ops = {
451 .statfs = simple_statfs,
452 .evict_inode = hypfs_evict_inode,
453 .show_options = hypfs_show_options,
456 static int __init hypfs_init(void)
460 rc = hypfs_dbfs_init();
463 if (hypfs_diag_init()) {
467 if (hypfs_vm_init()) {
469 goto fail_hypfs_diag_exit;
471 if (hypfs_sprp_init()) {
473 goto fail_hypfs_vm_exit;
475 if (hypfs_diag0c_init()) {
477 goto fail_hypfs_sprp_exit;
479 rc = sysfs_create_mount_point(hypervisor_kobj, "s390");
481 goto fail_hypfs_diag0c_exit;
482 rc = register_filesystem(&hypfs_type);
484 goto fail_filesystem;
488 sysfs_remove_mount_point(hypervisor_kobj, "s390");
489 fail_hypfs_diag0c_exit:
491 fail_hypfs_sprp_exit:
495 fail_hypfs_diag_exit:
497 pr_err("Initialization of hypfs failed with rc=%i\n", rc);
502 device_initcall(hypfs_init)