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
;
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 sbi
->update_file
= hypfs_create_update_file(root_dentry
);
304 if (IS_ERR(sbi
->update_file
))
305 return PTR_ERR(sbi
->update_file
);
306 hypfs_update_update(sb
);
307 pr_info("Hypervisor filesystem mounted\n");
311 static struct dentry
*hypfs_mount(struct file_system_type
*fst
, int flags
,
312 const char *devname
, void *data
)
314 return mount_single(fst
, flags
, data
, hypfs_fill_super
);
317 static void hypfs_kill_super(struct super_block
*sb
)
319 struct hypfs_sb_info
*sb_info
= sb
->s_fs_info
;
322 hypfs_delete_tree(sb
->s_root
);
323 if (sb_info
&& sb_info
->update_file
)
324 hypfs_remove(sb_info
->update_file
);
325 kfree(sb
->s_fs_info
);
326 sb
->s_fs_info
= NULL
;
327 kill_litter_super(sb
);
330 static struct dentry
*hypfs_create_file(struct dentry
*parent
, const char *name
,
331 char *data
, umode_t mode
)
333 struct dentry
*dentry
;
336 inode_lock(d_inode(parent
));
337 dentry
= lookup_one_len(name
, parent
, strlen(name
));
338 if (IS_ERR(dentry
)) {
339 dentry
= ERR_PTR(-ENOMEM
);
342 inode
= hypfs_make_inode(parent
->d_sb
, mode
);
345 dentry
= ERR_PTR(-ENOMEM
);
349 inode
->i_fop
= &hypfs_file_ops
;
351 inode
->i_size
= strlen(data
);
354 } else if (S_ISDIR(mode
)) {
355 inode
->i_op
= &simple_dir_inode_operations
;
356 inode
->i_fop
= &simple_dir_operations
;
357 inc_nlink(d_inode(parent
));
360 inode
->i_private
= data
;
361 d_instantiate(dentry
, inode
);
364 inode_unlock(d_inode(parent
));
368 struct dentry
*hypfs_mkdir(struct dentry
*parent
, const char *name
)
370 struct dentry
*dentry
;
372 dentry
= hypfs_create_file(parent
, name
, NULL
, S_IFDIR
| DIR_MODE
);
375 hypfs_add_dentry(dentry
);
379 static struct dentry
*hypfs_create_update_file(struct dentry
*dir
)
381 struct dentry
*dentry
;
383 dentry
= hypfs_create_file(dir
, "update", NULL
,
384 S_IFREG
| UPDATE_FILE_MODE
);
386 * We do not put the update file on the 'delete' list with
387 * hypfs_add_dentry(), since it should not be removed when the tree
393 struct dentry
*hypfs_create_u64(struct dentry
*dir
,
394 const char *name
, __u64 value
)
398 struct dentry
*dentry
;
400 snprintf(tmp
, TMP_SIZE
, "%llu\n", (unsigned long long int)value
);
401 buffer
= kstrdup(tmp
, GFP_KERNEL
);
403 return ERR_PTR(-ENOMEM
);
405 hypfs_create_file(dir
, name
, buffer
, S_IFREG
| REG_FILE_MODE
);
406 if (IS_ERR(dentry
)) {
408 return ERR_PTR(-ENOMEM
);
410 hypfs_add_dentry(dentry
);
414 struct dentry
*hypfs_create_str(struct dentry
*dir
,
415 const char *name
, char *string
)
418 struct dentry
*dentry
;
420 buffer
= kmalloc(strlen(string
) + 2, GFP_KERNEL
);
422 return ERR_PTR(-ENOMEM
);
423 sprintf(buffer
, "%s\n", string
);
425 hypfs_create_file(dir
, name
, buffer
, S_IFREG
| REG_FILE_MODE
);
426 if (IS_ERR(dentry
)) {
428 return ERR_PTR(-ENOMEM
);
430 hypfs_add_dentry(dentry
);
434 static const struct file_operations hypfs_file_ops
= {
436 .release
= hypfs_release
,
437 .read_iter
= hypfs_read_iter
,
438 .write_iter
= hypfs_write_iter
,
442 static struct file_system_type hypfs_type
= {
443 .owner
= THIS_MODULE
,
444 .name
= "s390_hypfs",
445 .mount
= hypfs_mount
,
446 .kill_sb
= hypfs_kill_super
449 static const struct super_operations hypfs_s_ops
= {
450 .statfs
= simple_statfs
,
451 .evict_inode
= hypfs_evict_inode
,
452 .show_options
= hypfs_show_options
,
455 static int __init
hypfs_init(void)
461 if (hypfs_diag_init()) {
465 if (hypfs_vm_init()) {
467 goto fail_hypfs_diag_exit
;
470 if (hypfs_diag0c_init()) {
472 goto fail_hypfs_sprp_exit
;
474 rc
= sysfs_create_mount_point(hypervisor_kobj
, "s390");
476 goto fail_hypfs_diag0c_exit
;
477 rc
= register_filesystem(&hypfs_type
);
479 goto fail_filesystem
;
483 sysfs_remove_mount_point(hypervisor_kobj
, "s390");
484 fail_hypfs_diag0c_exit
:
486 fail_hypfs_sprp_exit
:
489 fail_hypfs_diag_exit
:
493 pr_err("Initialization of hypfs failed with rc=%i\n", rc
);
496 device_initcall(hypfs_init
)