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/fs_context.h>
16 #include <linux/fs_parser.h>
17 #include <linux/namei.h>
18 #include <linux/vfs.h>
19 #include <linux/slab.h>
20 #include <linux/pagemap.h>
21 #include <linux/time.h>
22 #include <linux/sysfs.h>
23 #include <linux/init.h>
24 #include <linux/kobject.h>
25 #include <linux/seq_file.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
, };
212 static const struct fs_parameter_spec hypfs_fs_parameters
[] = {
213 fsparam_u32("gid", Opt_gid
),
214 fsparam_u32("uid", Opt_uid
),
218 static int hypfs_parse_param(struct fs_context
*fc
, struct fs_parameter
*param
)
220 struct hypfs_sb_info
*hypfs_info
= fc
->s_fs_info
;
221 struct fs_parse_result result
;
226 opt
= fs_parse(fc
, hypfs_fs_parameters
, param
, &result
);
232 uid
= make_kuid(current_user_ns(), result
.uint_32
);
234 return invalf(fc
, "Unknown uid");
235 hypfs_info
->uid
= uid
;
238 gid
= make_kgid(current_user_ns(), result
.uint_32
);
240 return invalf(fc
, "Unknown gid");
241 hypfs_info
->gid
= gid
;
247 static int hypfs_show_options(struct seq_file
*s
, struct dentry
*root
)
249 struct hypfs_sb_info
*hypfs_info
= root
->d_sb
->s_fs_info
;
251 seq_printf(s
, ",uid=%u", from_kuid_munged(&init_user_ns
, hypfs_info
->uid
));
252 seq_printf(s
, ",gid=%u", from_kgid_munged(&init_user_ns
, hypfs_info
->gid
));
256 static int hypfs_fill_super(struct super_block
*sb
, struct fs_context
*fc
)
258 struct hypfs_sb_info
*sbi
= sb
->s_fs_info
;
259 struct inode
*root_inode
;
260 struct dentry
*root_dentry
, *update_file
;
263 sb
->s_blocksize
= PAGE_SIZE
;
264 sb
->s_blocksize_bits
= PAGE_SHIFT
;
265 sb
->s_magic
= HYPFS_MAGIC
;
266 sb
->s_op
= &hypfs_s_ops
;
268 root_inode
= hypfs_make_inode(sb
, S_IFDIR
| 0755);
271 root_inode
->i_op
= &simple_dir_inode_operations
;
272 root_inode
->i_fop
= &simple_dir_operations
;
273 sb
->s_root
= root_dentry
= d_make_root(root_inode
);
277 rc
= hypfs_vm_create_files(root_dentry
);
279 rc
= hypfs_diag_create_files(root_dentry
);
282 update_file
= hypfs_create_update_file(root_dentry
);
283 if (IS_ERR(update_file
))
284 return PTR_ERR(update_file
);
285 sbi
->update_file
= update_file
;
286 hypfs_update_update(sb
);
287 pr_info("Hypervisor filesystem mounted\n");
291 static int hypfs_get_tree(struct fs_context
*fc
)
293 return get_tree_single(fc
, hypfs_fill_super
);
296 static void hypfs_free_fc(struct fs_context
*fc
)
298 kfree(fc
->s_fs_info
);
301 static const struct fs_context_operations hypfs_context_ops
= {
302 .free
= hypfs_free_fc
,
303 .parse_param
= hypfs_parse_param
,
304 .get_tree
= hypfs_get_tree
,
307 static int hypfs_init_fs_context(struct fs_context
*fc
)
309 struct hypfs_sb_info
*sbi
;
311 sbi
= kzalloc(sizeof(struct hypfs_sb_info
), GFP_KERNEL
);
315 mutex_init(&sbi
->lock
);
316 sbi
->uid
= current_uid();
317 sbi
->gid
= current_gid();
320 fc
->ops
= &hypfs_context_ops
;
324 static void hypfs_kill_super(struct super_block
*sb
)
326 struct hypfs_sb_info
*sb_info
= sb
->s_fs_info
;
329 hypfs_delete_tree(sb
->s_root
);
330 if (sb_info
&& sb_info
->update_file
)
331 hypfs_remove(sb_info
->update_file
);
332 kfree(sb
->s_fs_info
);
333 sb
->s_fs_info
= NULL
;
334 kill_litter_super(sb
);
337 static struct dentry
*hypfs_create_file(struct dentry
*parent
, const char *name
,
338 char *data
, umode_t mode
)
340 struct dentry
*dentry
;
343 inode_lock(d_inode(parent
));
344 dentry
= lookup_one_len(name
, parent
, strlen(name
));
345 if (IS_ERR(dentry
)) {
346 dentry
= ERR_PTR(-ENOMEM
);
349 inode
= hypfs_make_inode(parent
->d_sb
, mode
);
352 dentry
= ERR_PTR(-ENOMEM
);
356 inode
->i_fop
= &hypfs_file_ops
;
358 inode
->i_size
= strlen(data
);
361 } else if (S_ISDIR(mode
)) {
362 inode
->i_op
= &simple_dir_inode_operations
;
363 inode
->i_fop
= &simple_dir_operations
;
364 inc_nlink(d_inode(parent
));
367 inode
->i_private
= data
;
368 d_instantiate(dentry
, inode
);
371 inode_unlock(d_inode(parent
));
375 struct dentry
*hypfs_mkdir(struct dentry
*parent
, const char *name
)
377 struct dentry
*dentry
;
379 dentry
= hypfs_create_file(parent
, name
, NULL
, S_IFDIR
| DIR_MODE
);
382 hypfs_add_dentry(dentry
);
386 static struct dentry
*hypfs_create_update_file(struct dentry
*dir
)
388 struct dentry
*dentry
;
390 dentry
= hypfs_create_file(dir
, "update", NULL
,
391 S_IFREG
| UPDATE_FILE_MODE
);
393 * We do not put the update file on the 'delete' list with
394 * hypfs_add_dentry(), since it should not be removed when the tree
400 struct dentry
*hypfs_create_u64(struct dentry
*dir
,
401 const char *name
, __u64 value
)
405 struct dentry
*dentry
;
407 snprintf(tmp
, TMP_SIZE
, "%llu\n", (unsigned long long int)value
);
408 buffer
= kstrdup(tmp
, GFP_KERNEL
);
410 return ERR_PTR(-ENOMEM
);
412 hypfs_create_file(dir
, name
, buffer
, S_IFREG
| REG_FILE_MODE
);
413 if (IS_ERR(dentry
)) {
415 return ERR_PTR(-ENOMEM
);
417 hypfs_add_dentry(dentry
);
421 struct dentry
*hypfs_create_str(struct dentry
*dir
,
422 const char *name
, char *string
)
425 struct dentry
*dentry
;
427 buffer
= kmalloc(strlen(string
) + 2, GFP_KERNEL
);
429 return ERR_PTR(-ENOMEM
);
430 sprintf(buffer
, "%s\n", string
);
432 hypfs_create_file(dir
, name
, buffer
, S_IFREG
| REG_FILE_MODE
);
433 if (IS_ERR(dentry
)) {
435 return ERR_PTR(-ENOMEM
);
437 hypfs_add_dentry(dentry
);
441 static const struct file_operations hypfs_file_ops
= {
443 .release
= hypfs_release
,
444 .read_iter
= hypfs_read_iter
,
445 .write_iter
= hypfs_write_iter
,
449 static struct file_system_type hypfs_type
= {
450 .owner
= THIS_MODULE
,
451 .name
= "s390_hypfs",
452 .init_fs_context
= hypfs_init_fs_context
,
453 .parameters
= hypfs_fs_parameters
,
454 .kill_sb
= hypfs_kill_super
457 static const struct super_operations hypfs_s_ops
= {
458 .statfs
= simple_statfs
,
459 .evict_inode
= hypfs_evict_inode
,
460 .show_options
= hypfs_show_options
,
463 static int __init
hypfs_init(void)
469 if (hypfs_diag_init()) {
473 if (hypfs_vm_init()) {
475 goto fail_hypfs_diag_exit
;
478 if (hypfs_diag0c_init()) {
480 goto fail_hypfs_sprp_exit
;
482 rc
= sysfs_create_mount_point(hypervisor_kobj
, "s390");
484 goto fail_hypfs_diag0c_exit
;
485 rc
= register_filesystem(&hypfs_type
);
487 goto fail_filesystem
;
491 sysfs_remove_mount_point(hypervisor_kobj
, "s390");
492 fail_hypfs_diag0c_exit
:
494 fail_hypfs_sprp_exit
:
497 fail_hypfs_diag_exit
:
501 pr_err("Initialization of hypfs failed with rc=%i\n", rc
);
504 device_initcall(hypfs_init
)