Debian Codegraph @

src/basic/mountpoint-util.h

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3
4 #include "basic-forward.h"
5
6 /* The limit used for /dev itself. 4MB should be enough since device nodes and symlinks don't
7 * consume any space and udev isn't supposed to create regular file either. There's no limit on the
8 * max number of inodes since such limit is hard to guess especially on large storage array
9 * systems. */
10 #define TMPFS_LIMITS_DEV ",size=4m"
11
12 /* The limit used for /dev in private namespaces. 4MB for contents of regular files. The number of
13 * inodes should be relatively low in private namespaces but for now use a 64k limit. */
14 #define TMPFS_LIMITS_PRIVATE_DEV ",size=4m,nr_inodes=64k"
15
16 /* Very little, if any use expected */
17 #define TMPFS_LIMITS_EMPTY_OR_ALMOST ",size=4m,nr_inodes=1k"
18 #define TMPFS_LIMITS_SYS TMPFS_LIMITS_EMPTY_OR_ALMOST
19
20 /* On an extremely small device with only 256MB of RAM, 20% of RAM should be enough for the re-execution of
21 * PID1 because 16MB of free space is required. */
22 #define TMPFS_LIMITS_RUN ",size=20%,nr_inodes=800k"
23
24 /* The limit used for various nested tmpfs mounts, in particular for guests started by systemd-nspawn.
25 * 10% of RAM (using 16GB of RAM as a baseline) translates to 400k inodes (assuming 4k each) and 25%
26 * translates to 1M inodes.
27 * (On the host, /tmp is configured through a .mount unit file.) */
28 #define NESTED_TMPFS_LIMITS ",size=10%,nr_inodes=400k"
29
30 /* More space for volatile root and /var */
31 #define TMPFS_LIMITS_VAR ",size=25%,nr_inodes=1m"
32 #define TMPFS_LIMITS_ROOTFS TMPFS_LIMITS_VAR
33 #define TMPFS_LIMITS_VOLATILE_STATE TMPFS_LIMITS_VAR
34
35 bool is_name_to_handle_at_fatal_error(int err);
36
37 int name_to_handle_at_loop(int fd, const char *path, struct file_handle **ret_handle, int *ret_mnt_id, uint64_t *ret_unique_mnt_id, int flags);
38 int name_to_handle_at_try_fid(int fd, const char *path, struct file_handle **ret_handle, int *ret_mnt_id, uint64_t *ret_unique_mnt_id, int flags);
39 int name_to_handle_at_u64(int fd, const char *path, uint64_t *ret);
40 static inline int path_to_handle_u64(const char *path, uint64_t *ret) {
41 return name_to_handle_at_u64(AT_FDCWD, path, ret);
42 }
43 static inline int fd_to_handle_u64(int fd, uint64_t *ret) {
44 return name_to_handle_at_u64(fd, NULL, ret);
45 }
46
47 bool file_handle_equal(const struct file_handle *a, const struct file_handle *b);
48 struct file_handle* file_handle_dup(const struct file_handle *fh);
49
50 int path_get_mnt_id_at(int dir_fd, const char *path, int *ret);
51 static inline int path_get_mnt_id(const char *path, int *ret) {
52 return path_get_mnt_id_at(AT_FDCWD, path, ret);
53 }
54 int path_get_unique_mnt_id_at(int dir_fd, const char *path, uint64_t *ret);
55
56 int is_mount_point_at(int dir_fd, const char *path, int flags);
57 int path_is_mount_point_full(const char *path, const char *root, int flags);
58 static inline int path_is_mount_point(const char *path) {
59 return path_is_mount_point_full(path, NULL, 0);
60 }
61
62 bool fstype_is_network(const char *fstype);
63 bool fstype_needs_quota(const char *fstype);
64 bool fstype_has_internal_quota(const char *fstype);
65 bool fstype_is_api_vfs(const char *fstype);
66 bool fstype_is_blockdev_backed(const char *fstype);
67 bool fstype_is_ro(const char *fsype);
68 bool fstype_can_discard(const char *fstype);
69 bool fstype_can_ownership(const char *fstype);
70 bool fstype_can_uid_gid(const char *fstype);
71 bool fstype_can_fmask_dmask(const char *fstype);
72
73 const char* fstype_norecovery_option(const char *fstype);
74
75 int dev_is_devtmpfs(void);
76
77 int mount_nofollow(
78 const char *source,
79 const char *target,
80 const char *filesystemtype,
81 unsigned long mountflags,
82 const void *data);
83
84 const char* mount_propagation_flag_to_string(unsigned long flags);
85 int mount_propagation_flag_from_string(const char *name, unsigned long *ret);
86 bool mount_propagation_flag_is_valid(unsigned long flag);
87
88 bool mount_new_api_supported(void);
89
90 int mount_option_supported(const char *fstype, const char *key, const char *value);
91
92 bool path_below_api_vfs(const char *p);