mountctl man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

MOUNTCTL(2)		    BSD System Calls Manual		   MOUNTCTL(2)

NAME
     mountctl — execute a mount control operation

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/mountctl.h>

     int
     mountctl(const char *path, int op, int fd, void *ctl, int ctllen,
	 void *buf, int buflen);

DESCRIPTION
     The mountctl() system call executes the mount control operation op on the
     mount point path.	An optional file descriptor fd can be passed, or set
     to -1 if unneeded.	 The ctl argument is for passing operation specific
     data and usually points to some struct (see CONTROL OPERATIONS for fur‐
     ther information).	 The data's size is specified by ctllen.  The buf and
     buflen arguments are used if the operation needs to return data to the
     caller or set to NULL and 0 if unused.

CONTROL OPERATIONS
     The following operations are defined in <sys/mountctl.h>:

     MOUNTCTL_SET_EXPORT
	     Set export control of a filesystem.  This operation needs a
	     struct export_args passed in ctl.	Note that export control for
	     numerous filesystems may still only be settable with mount(2).
	     New software should attempt to use mountctl() before using the
	     old mount(2) method.

     MOUNTCTL_INSTALL_VFS_JOURNAL
	     Install a journal on a mount point.  This operation needs a
	     struct mountctl_install_journal passed in ctl.  The journal file
	     must be specified via fd.	A mount point may have multiple jour‐
	     nals attached to it.

     MOUNTCTL_REMOVE_VFS_JOURNAL
	     Disassociate a journal from a mount point.	 This operation needs
	     a struct mountctl_remove_journal passed in ctl.

     MOUNTCTL_RESTART_VFS_JOURNAL
	     Restart a journal with a new descriptor.  This operation needs a
	     struct mountctl_restart_journal passed in ctl.  The journal file
	     must be specified via fd.

     MOUNTCTL_STATUS_VFS_JOURNAL
	     Return a journal's status.	 This operation needs a struct
	     mountctl_status_journal passed in ctl and an array of struct
	     mountctl_journal_ret_status in buf.

     MOUNTCTL_MOUNTFLAGS
	     It will store a comma separated string buffer in the buf parame‐
	     ter with the name list of the currently set user mount flags. The
	     buf will be sized at most buflen bytes.

RETURN VALUES
     Upon successful completion, the number of copied bytes is returned; oth‐
     erwise the value -1 is returned and the global variable errno is set to
     indicate the error.

ERRORS
     The mountctl() function will fail when one of the following occurs:

     [EBADF]		Fd is not an active descriptor.

     [EINVAL]		The specified ctllen is not 0-1024, buflen is not
			0-16384, or path is NULL.

     [EPERM]		The caller is not the super-user.

SEE ALSO
     mount(2), mountctl(8)

HISTORY
     The mountctl() system call first appeared in DragonFly 1.1.

AUTHORS
     The mountctl() system call was written by Matthew Dillon and this manual
     page was written by Sascha Wildner.

BSD				 July 21, 2009				   BSD
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net