2001-12-03 00:25:04 +00:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice(s), this list of conditions and the following disclaimer as
|
|
|
|
|
.\" the first lines of this file unmodified other than the possible
|
|
|
|
|
.\" addition of one or more copyright notices.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
|
.\" notice(s), this list of conditions and the following disclaimer in the
|
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY
|
|
|
|
|
.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
|
|
|
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
|
.\" DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
|
|
|
|
|
.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
|
|
|
.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
|
|
|
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
|
|
.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
|
|
|
|
.\" DAMAGE.
|
|
|
|
|
.\"
|
|
|
|
|
.\" $FreeBSD$
|
|
|
|
|
.\"
|
2013-01-24 23:11:51 +00:00
|
|
|
.Dd January 25, 2012
|
2001-12-03 00:25:04 +00:00
|
|
|
.Dt VFS_SET 9
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm VFS_SET
|
2002-12-12 17:26:04 +00:00
|
|
|
.Nd set up loadable file system
|
2001-12-08 18:15:29 +00:00
|
|
|
.Vt vfsconf
|
2001-12-03 00:25:04 +00:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.In sys/param.h
|
2001-12-26 23:14:04 +00:00
|
|
|
.In sys/kernel.h
|
|
|
|
|
.In sys/module.h
|
2001-12-03 00:25:04 +00:00
|
|
|
.In sys/mount.h
|
|
|
|
|
.Ft void
|
2001-12-26 23:14:04 +00:00
|
|
|
.Fn VFS_SET "struct vfsops *vfsops" "fsname" "int flags"
|
2001-12-03 00:25:04 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Fn VFS_SET
|
2001-12-08 18:15:29 +00:00
|
|
|
creates a
|
|
|
|
|
.Vt vfsconf
|
|
|
|
|
structure for the loadable module with the given
|
|
|
|
|
.Fa vfsops , fsname
|
|
|
|
|
and
|
|
|
|
|
.Fa flags ,
|
|
|
|
|
and declares it by calling
|
|
|
|
|
.Xr DECLARE_MODULE 9
|
2001-12-03 00:25:04 +00:00
|
|
|
using
|
|
|
|
|
.Fn vfs_modevent
|
|
|
|
|
as the event handler.
|
2003-05-16 15:21:20 +00:00
|
|
|
.Pp
|
|
|
|
|
Possible values for the
|
|
|
|
|
.Fa flags
|
2005-01-07 12:01:11 +00:00
|
|
|
argument are:
|
Update ZFS from version 6 to 13 and bring some FreeBSD-specific changes.
This bring huge amount of changes, I'll enumerate only user-visible changes:
- Delegated Administration
Allows regular users to perform ZFS operations, like file system
creation, snapshot creation, etc.
- L2ARC
Level 2 cache for ZFS - allows to use additional disks for cache.
Huge performance improvements mostly for random read of mostly
static content.
- slog
Allow to use additional disks for ZFS Intent Log to speed up
operations like fsync(2).
- vfs.zfs.super_owner
Allows regular users to perform privileged operations on files stored
on ZFS file systems owned by him. Very careful with this one.
- chflags(2)
Not all the flags are supported. This still needs work.
- ZFSBoot
Support to boot off of ZFS pool. Not finished, AFAIK.
Submitted by: dfr
- Snapshot properties
- New failure modes
Before if write requested failed, system paniced. Now one
can select from one of three failure modes:
- panic - panic on write error
- wait - wait for disk to reappear
- continue - serve read requests if possible, block write requests
- Refquota, refreservation properties
Just quota and reservation properties, but don't count space consumed
by children file systems, clones and snapshots.
- Sparse volumes
ZVOLs that don't reserve space in the pool.
- External attributes
Compatible with extattr(2).
- NFSv4-ACLs
Not sure about the status, might not be complete yet.
Submitted by: trasz
- Creation-time properties
- Regression tests for zpool(8) command.
Obtained from: OpenSolaris
2008-11-17 20:49:29 +00:00
|
|
|
.Bl -hang -width ".Dv VFCF_DELEGADMIN"
|
2003-05-16 15:21:20 +00:00
|
|
|
.It Dv VFCF_STATIC
|
|
|
|
|
File system should be statically available in the kernel.
|
|
|
|
|
.It Dv VFCF_NETWORK
|
|
|
|
|
Network exportable file system.
|
|
|
|
|
.It Dv VFCF_READONLY
|
|
|
|
|
Does not support write operations.
|
|
|
|
|
.It Dv VFCF_SYNTHETIC
|
|
|
|
|
Pseudo file system, data does not represent on-disk files.
|
|
|
|
|
.It Dv VFCF_LOOPBACK
|
|
|
|
|
Loopback file system layer.
|
|
|
|
|
.It Dv VFCF_UNICODE
|
|
|
|
|
File names are stored as Unicode.
|
2007-04-05 21:03:05 +00:00
|
|
|
.It Dv VFCF_JAIL
|
Update ZFS from version 6 to 13 and bring some FreeBSD-specific changes.
This bring huge amount of changes, I'll enumerate only user-visible changes:
- Delegated Administration
Allows regular users to perform ZFS operations, like file system
creation, snapshot creation, etc.
- L2ARC
Level 2 cache for ZFS - allows to use additional disks for cache.
Huge performance improvements mostly for random read of mostly
static content.
- slog
Allow to use additional disks for ZFS Intent Log to speed up
operations like fsync(2).
- vfs.zfs.super_owner
Allows regular users to perform privileged operations on files stored
on ZFS file systems owned by him. Very careful with this one.
- chflags(2)
Not all the flags are supported. This still needs work.
- ZFSBoot
Support to boot off of ZFS pool. Not finished, AFAIK.
Submitted by: dfr
- Snapshot properties
- New failure modes
Before if write requested failed, system paniced. Now one
can select from one of three failure modes:
- panic - panic on write error
- wait - wait for disk to reappear
- continue - serve read requests if possible, block write requests
- Refquota, refreservation properties
Just quota and reservation properties, but don't count space consumed
by children file systems, clones and snapshots.
- Sparse volumes
ZVOLs that don't reserve space in the pool.
- External attributes
Compatible with extattr(2).
- NFSv4-ACLs
Not sure about the status, might not be complete yet.
Submitted by: trasz
- Creation-time properties
- Regression tests for zpool(8) command.
Obtained from: OpenSolaris
2008-11-17 20:49:29 +00:00
|
|
|
Can be mounted from within a jail if
|
2007-04-05 21:03:05 +00:00
|
|
|
.Va security.jail.mount_allowed
|
|
|
|
|
sysctl is set to
|
|
|
|
|
.Dv 1 .
|
Update ZFS from version 6 to 13 and bring some FreeBSD-specific changes.
This bring huge amount of changes, I'll enumerate only user-visible changes:
- Delegated Administration
Allows regular users to perform ZFS operations, like file system
creation, snapshot creation, etc.
- L2ARC
Level 2 cache for ZFS - allows to use additional disks for cache.
Huge performance improvements mostly for random read of mostly
static content.
- slog
Allow to use additional disks for ZFS Intent Log to speed up
operations like fsync(2).
- vfs.zfs.super_owner
Allows regular users to perform privileged operations on files stored
on ZFS file systems owned by him. Very careful with this one.
- chflags(2)
Not all the flags are supported. This still needs work.
- ZFSBoot
Support to boot off of ZFS pool. Not finished, AFAIK.
Submitted by: dfr
- Snapshot properties
- New failure modes
Before if write requested failed, system paniced. Now one
can select from one of three failure modes:
- panic - panic on write error
- wait - wait for disk to reappear
- continue - serve read requests if possible, block write requests
- Refquota, refreservation properties
Just quota and reservation properties, but don't count space consumed
by children file systems, clones and snapshots.
- Sparse volumes
ZVOLs that don't reserve space in the pool.
- External attributes
Compatible with extattr(2).
- NFSv4-ACLs
Not sure about the status, might not be complete yet.
Submitted by: trasz
- Creation-time properties
- Regression tests for zpool(8) command.
Obtained from: OpenSolaris
2008-11-17 20:49:29 +00:00
|
|
|
.It Dv VFCF_DELEGADMIN
|
|
|
|
|
Supports delegated administration if
|
|
|
|
|
.Va vfs.usermount
|
|
|
|
|
sysctl is set to
|
|
|
|
|
.Dv 1 .
|
2003-05-16 15:21:20 +00:00
|
|
|
.El
|
2005-01-18 20:37:11 +00:00
|
|
|
.Sh PSEUDOCODE
|
2001-12-03 00:25:04 +00:00
|
|
|
.Bd -literal
|
2001-12-08 18:15:29 +00:00
|
|
|
/*
|
2013-01-24 23:11:51 +00:00
|
|
|
* Fill in the ones we redefine. The unused fields will be
|
|
|
|
|
* automatically initialized by pointers to vfs_std* functions
|
|
|
|
|
* during file system registration.
|
2001-12-08 18:15:29 +00:00
|
|
|
*/
|
|
|
|
|
static struct vfsops myfs_vfsops = {
|
2013-01-21 20:15:35 +00:00
|
|
|
.vfs_mount = myfs_mount,
|
|
|
|
|
.vfs_root = myfs_root,
|
|
|
|
|
.vfs_statfs = myfs_statfs,
|
|
|
|
|
.vfs_unmount = myfs_unmount,
|
2001-12-08 18:15:29 +00:00
|
|
|
};
|
2001-12-03 00:25:04 +00:00
|
|
|
|
2013-01-21 20:15:35 +00:00
|
|
|
VFS_SET(myfs_vfsops, myfs, 0);
|
2001-12-03 00:25:04 +00:00
|
|
|
.Ed
|
|
|
|
|
.Sh SEE ALSO
|
2007-04-05 21:03:05 +00:00
|
|
|
.Xr jail 2 ,
|
|
|
|
|
.Xr jail 8 ,
|
2001-12-08 18:15:29 +00:00
|
|
|
.Xr DECLARE_MODULE 9 ,
|
2001-12-03 00:25:04 +00:00
|
|
|
.Xr vfsconf 9 ,
|
2001-12-08 18:15:29 +00:00
|
|
|
.Xr vfs_modevent 9
|
2001-12-03 00:25:04 +00:00
|
|
|
.Sh AUTHORS
|
2003-10-23 06:24:55 +00:00
|
|
|
This manual page was written by
|
2001-12-03 00:25:04 +00:00
|
|
|
.An Chad David Aq davidc@acns.ab.ca .
|