1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
|
/*
* mount.h - libmount API
*
* Copyright (C) 2008-2009 Karel Zak <kzak@redhat.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef _LIBMOUNT_MOUNT_H
#define _LIBMOUNT_MOUNT_H
#ifdef __cplusplus
extern "C" {
#endif
#ifndef USE_UNSTABLE_LIBMOUNT_API
# warning libmount API is not stable yet!
#endif
#include <stdio.h>
#include <mntent.h>
#include <sys/types.h>
#define LIBMOUNT_VERSION "@LIBMOUNT_VERSION@"
/**
* mnt_cache:
*
* Stores canonicalized paths and evaluated tags
*/
typedef struct _mnt_cache mnt_cache;
/**
* mnt_lock:
*
* Stores information about locked file (e.g. /etc/mtab)
*/
typedef struct _mnt_lock mnt_lock;
/**
* mnt_iter:
*
* Generic iterator (stores state about lists)
*/
typedef struct _mnt_iter mnt_iter;
/**
* mnt_optmap:
*
* Mount options description (map)
*/
struct mnt_optmap
{
const char *name; /* option name[=%<type>] (e.g. "loop[=%s]") */
int id; /* option ID or MS_* flags (e.g MS_RDONLY) */
int mask; /* MNT_{NOMTAB,INVERT,...} mask */
};
/*
* mount options map masks
*/
#define MNT_INVERT (1 << 1) /* invert the mountflag */
#define MNT_NOMTAB (1 << 2) /* skip in the mtab option string */
/**
* mnt_fs:
*
* Parsed fstab/mtab/mountinfo entry
*/
typedef struct _mnt_fs mnt_fs;
/**
* mnt_tab:
*
* List of mnt_fs entries (parsed fstab/mtab/mountinfo)
*/
typedef struct _mnt_tab mnt_tab;
/**
* mnt_update
*
* /etc/mtab or /dev/.mount/utab update description
*/
typedef struct _mnt_update mnt_update;
/**
* mnt_context
*
* Mount/umount status
*/
typedef struct _mnt_context mnt_context;
/*
* Actions
*/
enum {
MNT_ACT_MOUNT = 1,
MNT_ACT_UMOUNT
};
/* init.c */
extern void mnt_init_debug(int mask);
/* version.c */
extern int mnt_parse_version_string(const char *ver_string);
extern int mnt_get_library_version(const char **ver_string);
/* utils.c */
extern char *mnt_mangle(const char *str);
extern char *mnt_unmangle(const char *str);
extern int mnt_fstype_is_netfs(const char *type);
extern int mnt_fstype_is_pseudofs(const char *type);
extern int mnt_match_fstype(const char *type, const char *pattern);
extern int mnt_match_options(const char *optstr, const char *pattern);
extern const char *mnt_get_fstab_path(void);
extern const char *mnt_get_mtab_path(void);
extern int mnt_has_regular_mtab(const char **mtab, int *writable);
/* cache.c */
extern mnt_cache *mnt_new_cache(void);
extern void mnt_free_cache(mnt_cache *cache);
extern int mnt_cache_read_tags(mnt_cache *cache, const char *devname);
extern int mnt_cache_device_has_tag(mnt_cache *cache, const char *devname,
const char *token, const char *value);
extern char *mnt_cache_find_tag_value(mnt_cache *cache,
const char *devname, const char *token);
extern char *mnt_get_fstype(const char *devname, int *ambi, mnt_cache *cache);
extern char *mnt_resolve_path(const char *path, mnt_cache *cache);
extern char *mnt_resolve_tag(const char *token, const char *value, mnt_cache *cache);
extern char *mnt_resolve_spec(const char *spec, mnt_cache *cache);
/* optstr.c */
extern int mnt_optstr_next_option(char **optstr, char **name, size_t *namesz,
char **value, size_t *valuesz);
extern int mnt_optstr_append_option(char **optstr, const char *name,
const char *value);
extern int mnt_optstr_prepend_option(char **optstr, const char *name,
const char *value);
extern int mnt_optstr_get_option(char *optstr, const char *name,
char **value, size_t *valsz);
extern int mnt_optstr_set_option(char **optstr, const char *name,
const char *value);
extern int mnt_optstr_remove_option(char **optstr, const char *name);
extern int mnt_split_optstr(const char *optstr,
char **user, char **vfs, char **fs,
int ignore_user, int ignore_vfs);
extern int mnt_optstr_get_options(const char *optstr, char **subset,
const struct mnt_optmap *map, int ignore);
extern int mnt_optstr_get_flags(const char *optstr, unsigned long *flags,
const struct mnt_optmap *map);
extern int mnt_optstr_apply_flags(char **optstr, unsigned long flags,
const struct mnt_optmap *map);
/* iter.c */
enum {
MNT_ITER_FORWARD = 0,
MNT_ITER_BACKWARD
};
extern mnt_iter *mnt_new_iter(int direction);
extern void mnt_free_iter(mnt_iter *itr);
extern void mnt_reset_iter(mnt_iter *itr, int direction);
extern int mnt_iter_get_direction(mnt_iter *itr);
/* optmap.c */
enum {
MNT_LINUX_MAP = 1,
MNT_USERSPACE_MAP
};
extern const struct mnt_optmap *mnt_get_builtin_optmap(int id);
/* lock.c */
extern mnt_lock *mnt_new_lock(const char *datafile, pid_t id);
extern void mnt_free_lock(mnt_lock *ml);
extern void mnt_unlock_file(mnt_lock *ml);
extern int mnt_lock_file(mnt_lock *ml);
/* fs.c */
extern mnt_fs *mnt_new_fs(void);
extern void mnt_free_fs(mnt_fs *fs);
extern mnt_fs *mnt_copy_fs(const mnt_fs *fs);
extern void *mnt_fs_get_userdata(mnt_fs *fs);
extern int mnt_fs_set_userdata(mnt_fs *fs, void *data);
extern const char *mnt_fs_get_source(mnt_fs *fs);
extern int mnt_fs_set_source(mnt_fs *fs, const char *source);
extern const char *mnt_fs_get_srcpath(mnt_fs *fs);
extern int mnt_fs_get_tag(mnt_fs *fs, const char **name, const char **value);
extern const char *mnt_fs_get_target(mnt_fs *fs);
extern int mnt_fs_set_target(mnt_fs *fs, const char *target);
extern const char *mnt_fs_get_fstype(mnt_fs *fs);
extern int mnt_fs_set_fstype(mnt_fs *fs, const char *fstype);
extern char *mnt_fs_strdup_options(mnt_fs *fs);
extern int mnt_fs_set_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_get_option(mnt_fs *fs, const char *name,
char **value, size_t *valsz);
extern int mnt_fs_append_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_prepend_options(mnt_fs *fs, const char *optstr);
extern const char *mnt_fs_get_fs_options(mnt_fs *fs);
extern int mnt_fs_set_fs_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_append_fs_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_prepend_fs_options(mnt_fs *fs, const char *optstr);
extern const char *mnt_fs_get_vfs_options(mnt_fs *fs);
extern int mnt_fs_set_vfs_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_append_vfs_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_prepend_vfs_options(mnt_fs *fs, const char *optstr);
extern const char *mnt_fs_get_userspace_options(mnt_fs *fs);
extern int mnt_fs_set_userspace_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_append_userspace_options(mnt_fs *fs, const char *optstr);
extern int mnt_fs_prepend_userspace_options(mnt_fs *fs, const char *optstr);
extern const char *mnt_fs_get_attributes(mnt_fs *fs);
extern int mnt_fs_set_attributes(mnt_fs *fs, const char *optstr);
extern int mnt_fs_get_attribute(mnt_fs *fs, const char *name,
char **value, size_t *valsz);
extern int mnt_fs_append_attributes(mnt_fs *fs, const char *optstr);
extern int mnt_fs_prepend_attributes(mnt_fs *fs, const char *optstr);
extern int mnt_fs_get_freq(mnt_fs *fs);
extern int mnt_fs_set_freq(mnt_fs *fs, int freq);
extern int mnt_fs_get_passno(mnt_fs *fs);
extern int mnt_fs_set_passno(mnt_fs *fs, int passno);
extern const char *mnt_fs_get_root(mnt_fs *fs);
extern int mnt_fs_set_root(mnt_fs *fs, const char *root);
extern const char *mnt_fs_get_bindsrc(mnt_fs *fs);
extern int mnt_fs_set_bindsrc(mnt_fs *fs, const char *src);
extern int mnt_fs_get_id(mnt_fs *fs);
extern int mnt_fs_get_parent_id(mnt_fs *fs);
extern dev_t mnt_fs_get_devno(mnt_fs *fs);
extern int mnt_fs_match_target(mnt_fs *fs, const char *target, mnt_cache *cache);
extern int mnt_fs_match_source(mnt_fs *fs, const char *source, mnt_cache *cache);
extern int mnt_fs_match_fstype(mnt_fs *fs, const char *types);
extern int mnt_fs_match_options(mnt_fs *fs, const char *options);
extern int mnt_fs_print_debug(mnt_fs *fs, FILE *file);
extern void mnt_free_mntent(struct mntent *mnt);
extern int mnt_fs_to_mntent(mnt_fs *fs, struct mntent **mnt);
/* tab-parse.c */
extern mnt_tab *mnt_new_tab_from_file(const char *filename);
extern mnt_tab *mnt_new_tab_from_dir(const char *dirname);
extern int mnt_tab_parse_stream(mnt_tab *tb, FILE *f, const char *filename);
extern int mnt_tab_parse_file(mnt_tab *tb, const char *filename);
extern int mnt_tab_parse_fstab(mnt_tab *tb, const char *filename);
extern int mnt_tab_parse_mtab(mnt_tab *tb, const char *filename);
extern int mnt_tab_set_parser_errcb(mnt_tab *tb,
int (*cb)(mnt_tab *tb, const char *filename, int line));
/* tab.c */
extern mnt_tab *mnt_new_tab(void);
extern void mnt_free_tab(mnt_tab *tb);
extern int mnt_tab_get_nents(mnt_tab *tb);
extern int mnt_tab_set_cache(mnt_tab *tb, mnt_cache *mpc);
extern mnt_cache *mnt_tab_get_cache(mnt_tab *tb);
extern const char *mnt_tab_get_name(mnt_tab *tb);
extern int mnt_tab_add_fs(mnt_tab *tb, mnt_fs *fs);
extern int mnt_tab_remove_fs(mnt_tab *tb, mnt_fs *fs);
extern int mnt_tab_next_fs(mnt_tab *tb, mnt_iter *itr, mnt_fs **fs);
extern int mnt_tab_next_child_fs(mnt_tab *tb, mnt_iter *itr,
mnt_fs *parent, mnt_fs **chld);
extern int mnt_tab_get_root_fs(mnt_tab *tb, mnt_fs **root);
extern int mnt_tab_set_iter(mnt_tab *tb, mnt_iter *itr, mnt_fs *fs);
extern mnt_fs *mnt_tab_find_target(mnt_tab *tb, const char *path, int direction);
extern mnt_fs *mnt_tab_find_srcpath(mnt_tab *tb, const char *path, int direction);
extern mnt_fs *mnt_tab_find_tag(mnt_tab *tb, const char *tag,
const char *val, int direction);
extern mnt_fs *mnt_tab_find_source(mnt_tab *tb, const char *source, int direction);
extern mnt_fs *mnt_tab_find_pair(mnt_tab *tb, const char *source,
const char *target, int direction);
extern int mnt_tab_find_next_fs(mnt_tab *tb, mnt_iter *itr,
int (*match_func)(mnt_fs *, void *), void *userdata,
mnt_fs **fs);
/* tab_update.c */
extern mnt_update *mnt_new_update(void);
extern void mnt_free_update(mnt_update *upd);
extern int mnt_update_is_ready(mnt_update *upd);
extern int mnt_update_set_fs(mnt_update *upd, unsigned long mountflags,
const char *target, mnt_fs *fs);
extern int mnt_update_tab(mnt_update *upd, mnt_lock *lc);
extern unsigned long mnt_update_get_mountflags(mnt_update *upd);
extern int mnt_update_force_rdonly(mnt_update *upd, int rdonly);
extern const char *mnt_update_get_filename(mnt_update *upd);
extern mnt_fs *mnt_update_get_fs(mnt_update *upd);
/* context.c */
/* mode for mount options from fstab */
enum {
MNT_OMODE_IGNORE = (1 << 1), /* ignore mtab/fstab options */
MNT_OMODE_APPEND = (1 << 2), /* append mtab/fstab options to existing options */
MNT_OMODE_PREPEND = (1 << 3), /* prepend mtab/fstab options to existing options */
MNT_OMODE_REPLACE = (1 << 4), /* replace existing options with options from mtab/fstab */
MNT_OMODE_FORCE = (1 << 5), /* always read mtab/fstab options */
MNT_OMODE_FSTAB = (1 << 10), /* read from fstab */
MNT_OMODE_MTAB = (1 << 11), /* read from mtab if fstab not enabled or failed */
/* default */
MNT_OMODE_AUTO = (MNT_OMODE_PREPEND | MNT_OMODE_FSTAB | MNT_OMODE_MTAB),
/* non-root users */
MNT_OMODE_USER = (MNT_OMODE_REPLACE | MNT_OMODE_FORCE | MNT_OMODE_FSTAB)
};
extern mnt_context *mnt_new_context(void);
extern void mnt_free_context(mnt_context *cxt);
extern int mnt_reset_context(mnt_context *cxt);
extern int mnt_context_is_restricted(mnt_context *cxt);
extern int mnt_context_set_optsmode(mnt_context *cxt, int mode);
extern int mnt_context_disable_canonicalize(mnt_context *cxt, int disable);
extern int mnt_context_enable_lazy(mnt_context *cxt, int enable);
extern int mnt_context_enable_rdonly_umount(mnt_context *cxt, int enable);
extern int mnt_context_disable_helpers(mnt_context *cxt, int disable);
extern int mnt_context_enable_sloppy(mnt_context *cxt, int enable);
extern int mnt_context_enable_fake(mnt_context *cxt, int enable);
extern int mnt_context_disable_mtab(mnt_context *cxt, int disable);
extern int mnt_context_enable_force(mnt_context *cxt, int enable);
extern int mnt_context_enable_verbose(mnt_context *cxt, int enable);
extern int mnt_context_enable_loopdel(mnt_context *cxt, int enable);
extern int mnt_context_get_optsmode(mnt_context *cxt);
extern int mnt_context_is_lazy(mnt_context *cxt);
extern int mnt_context_is_rdonly_umount(mnt_context *cxt);
extern int mnt_context_is_sloppy(mnt_context *cxt);
extern int mnt_context_is_fake(mnt_context *cxt);
extern int mnt_context_is_nomtab(mnt_context *cxt);
extern int mnt_context_is_force(mnt_context *cxt);
extern int mnt_context_is_verbose(mnt_context *cxt);
extern int mnt_context_set_fs(mnt_context *cxt, mnt_fs *fs);
extern mnt_fs *mnt_context_get_fs(mnt_context *cxt);
extern int mnt_context_set_source(mnt_context *cxt, const char *source);
extern int mnt_context_set_target(mnt_context *cxt, const char *target);
extern int mnt_context_set_fstype(mnt_context *cxt, const char *fstype);
extern int mnt_context_set_options(mnt_context *cxt, const char *optstr);
extern int mnt_context_append_options(mnt_context *cxt, const char *optstr);
extern int mnt_context_set_fstype_pattern(mnt_context *cxt, const char *pattern);
extern int mnt_context_set_options_pattern(mnt_context *cxt, const char *pattern);
extern int mnt_context_set_fstab(mnt_context *cxt, mnt_tab *tb);
extern int mnt_context_get_fstab(mnt_context *cxt, mnt_tab **tb);
extern int mnt_context_get_mtab(mnt_context *cxt, mnt_tab **tb);
extern int mnt_context_set_cache(mnt_context *cxt, mnt_cache *cache);
extern mnt_cache *mnt_context_get_cache(mnt_context *cxt);
extern mnt_lock *mnt_context_get_lock(mnt_context *cxt);
extern int mnt_context_set_mountflags(mnt_context *cxt, unsigned long flags);
extern int mnt_context_get_mountflags(mnt_context *cxt, unsigned long *flags);
extern int mnt_context_set_userspace_mountflags(mnt_context *cxt, unsigned long flags);
extern int mnt_context_get_userspace_mountflags(mnt_context *cxt, unsigned long *flags);
extern int mnt_context_set_mountdata(mnt_context *cxt, void *data);
extern int mnt_context_apply_fstab(mnt_context *cxt);
extern int mnt_context_get_status(mnt_context *cxt);
extern int mnt_context_strerror(mnt_context *cxt, char *buf, size_t bufsiz);
extern int mnt_mount_context(mnt_context *cxt);
extern int mnt_context_prepare_mount(mnt_context *cxt);
extern int mnt_context_do_mount(mnt_context *cxt);
extern int mnt_context_finalize_mount(mnt_context *cxt);
extern int mnt_context_do_umount(mnt_context *cxt);
/*
* mount(8) userspace options masks (MNT_MAP_USERSPACE map)
*/
#define MNT_MS_NOAUTO (1 << 2)
#define MNT_MS_USER (1 << 3)
#define MNT_MS_USERS (1 << 4)
#define MNT_MS_OWNER (1 << 5)
#define MNT_MS_GROUP (1 << 6)
#define MNT_MS_NETDEV (1 << 7)
#define MNT_MS_COMMENT (1 << 8)
#define MNT_MS_LOOP (1 << 9)
#define MNT_MS_NOFAIL (1 << 10)
#define MNT_MS_UHELPER (1 << 11)
/*
* mount(2) MS_* masks (MNT_MAP_LINUX map)
*/
#ifndef MS_RDONLY
#define MS_RDONLY 1 /* Mount read-only */
#endif
#ifndef MS_NOSUID
#define MS_NOSUID 2 /* Ignore suid and sgid bits */
#endif
#ifndef MS_NODEV
#define MS_NODEV 4 /* Disallow access to device special files */
#endif
#ifndef MS_NOEXEC
#define MS_NOEXEC 8 /* Disallow program execution */
#endif
#ifndef MS_SYNCHRONOUS
#define MS_SYNCHRONOUS 16 /* Writes are synced at once */
#endif
#ifndef MS_REMOUNT
#define MS_REMOUNT 32 /* Alter flags of a mounted FS */
#endif
#ifndef MS_MANDLOCK
#define MS_MANDLOCK 64 /* Allow mandatory locks on an FS */
#endif
#ifndef MS_DIRSYNC
#define MS_DIRSYNC 128 /* Directory modifications are synchronous */
#endif
#ifndef MS_NOATIME
#define MS_NOATIME 0x400 /* 1024: Do not update access times. */
#endif
#ifndef MS_NODIRATIME
#define MS_NODIRATIME 0x800 /* 2048: Don't update directory access times */
#endif
#ifndef MS_BIND
#define MS_BIND 0x1000 /* 4096: Mount existing tree also elsewhere */
#endif
#ifndef MS_MOVE
#define MS_MOVE 0x2000 /* 8192: Atomically move tree */
#endif
#ifndef MS_REC
#define MS_REC 0x4000 /* 16384: Recursive loopback */
#endif
#ifndef MS_VERBOSE
#define MS_VERBOSE 0x8000 /* 32768 */
#endif
#ifndef MS_RELATIME
#define MS_RELATIME 0x200000 /* 200000: Update access times relative
to mtime/ctime */
#endif
#ifndef MS_UNBINDABLE
#define MS_UNBINDABLE (1<<17) /* 131072 unbindable*/
#endif
#ifndef MS_PRIVATE
#define MS_PRIVATE (1<<18) /* 262144 Private*/
#endif
#ifndef MS_SLAVE
#define MS_SLAVE (1<<19) /* 524288 Slave*/
#endif
#ifndef MS_SHARED
#define MS_SHARED (1<<20) /* 1048576 Shared*/
#endif
#ifndef MS_I_VERSION
#define MS_I_VERSION (1<<23) /* update inode I_version field */
#endif
#ifndef MS_STRICTATIME
#define MS_STRICTATIME (1<<24) /* strict atime semantics */
#endif
/*
* Magic mount flag number. Had to be or-ed to the flag values.
*/
#ifndef MS_MGC_VAL
#define MS_MGC_VAL 0xC0ED0000 /* magic flag number to indicate "new" flags */
#endif
#ifndef MS_MGC_MSK
#define MS_MGC_MSK 0xffff0000 /* magic flag number mask */
#endif
/* Shared-subtree options */
#define MS_PROPAGATION (MS_SHARED|MS_SLAVE|MS_UNBINDABLE|MS_PRIVATE)
/* Options that we make ordinary users have by default. */
#define MS_SECURE (MS_NOEXEC|MS_NOSUID|MS_NODEV)
/* Options that we make owner-mounted devices have by default */
#define MS_OWNERSECURE (MS_NOSUID|MS_NODEV)
#ifdef __cplusplus
}
#endif
#endif /* _LIBMOUNT_MOUNT_H */
|
