3 .\" The DragonFly Project. All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in
13 .\" the documentation and/or other materials provided with the
15 .\" 3. Neither the name of The DragonFly Project nor the names of its
16 .\" contributors may be used to endorse or promote products derived
17 .\" from this software without specific, prior written permission.
19 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
23 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
25 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" $DragonFly: src/lib/libc/sys/mountctl.2,v 1.3 2008/02/10 23:35:30 swildner Exp $
39 .Nd execute a mount control operation
46 .Fa "const char *path"
57 system call executes the mount control operation
61 An optional file descriptor
63 can be passed, or set to -1 if unneeded.
66 argument is for passing operation specific data and usually points to
68 .Sx CONTROL OPERATIONS
69 for further information).
70 The data's size is specified by
76 arguments are used if the operation needs to return data to the caller
80 .Sh CONTROL OPERATIONS
81 The following operations are defined in
83 .Bl -tag -width indent
84 .It Dv MOUNTCTL_SET_EXPORT
85 Set export control of a filesystem.
86 This operation needs a
87 .Vt struct export_args
90 Note that export control for numerous filesystems may still only be settable
93 New software should attempt to use
98 .It Dv MOUNTCTL_INSTALL_VFS_JOURNAL
99 Install a journal on a mount point.
100 This operation needs a
101 .Vt struct mountctl_install_journal
104 The journal file must be specified via
106 A mount point may have multiple journals attached to it.
107 .It Dv MOUNTCTL_REMOVE_VFS_JOURNAL
108 Disassociate a journal from a mount point.
109 This operation needs a
110 .Vt struct mountctl_remove_journal
113 .It Dv MOUNTCTL_RESTART_VFS_JOURNAL
114 Restart a journal with a new descriptor.
115 This operation needs a
116 .Vt struct mountctl_restart_journal
119 The journal file must be specified via
121 .It Dv MOUNTCTL_STATUS_VFS_JOURNAL
122 Return a journal's status.
123 This operation needs a
124 .Vt struct mountctl_status_journal
128 .Vt struct mountctl_journal_ret_status
131 .\" XXX Not yet implemented:
132 .\".It Dv MOUNTCTL_INSTALL_BLK_JOURNAL
133 .\".It Dv MOUNTCTL_REMOVE_BLK_JOURNAL
134 .\".It Dv MOUNTCTL_RESYNC_BLK_JOURNAL
135 .\".It Dv MOUNTCTL_RESYNC_VFS_JOURNAL
136 .\".It Dv MOUNTCTL_STATUS_BLK_JOURNAL
143 function will fail when one of the following occurs:
147 is not an active descriptor.
158 The caller is not the super-user.
166 system call first appeared in
172 system call was written by
174 and this manual page was written by