projects / mirror_zfs.git / blame
| Commit | Line | Data |
|---|---|---|
| cf2129e6 DH |
1 | '\" t |
| 2 | .\" | |
| 3 | .\" CDDL HEADER START | |
| 4 | .\" | |
| 5 | .\" The contents of this file are subject to the terms of the | |
| 6 | .\" Common Development and Distribution License (the "License"). | |
| 7 | .\" You may not use this file except in compliance with the License. | |
| 8 | .\" | |
| 9 | .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE | |
| 10 | .\" or http://www.opensolaris.org/os/licensing. | |
| 11 | .\" See the License for the specific language governing permissions | |
| 12 | .\" and limitations under the License. | |
| 13 | .\" | |
| 14 | .\" When distributing Covered Code, include this CDDL HEADER in each | |
| 15 | .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. | |
| 16 | .\" If applicable, add the following below this CDDL HEADER, with the | |
| 17 | .\" fields enclosed by brackets "[]" replaced with your own identifying | |
| 18 | .\" information: Portions Copyright [yyyy] [name of copyright owner] | |
| 19 | .\" | |
| 20 | .\" CDDL HEADER END | |
| 21 | .\" | |
| 22 | .\" | |
| 23 | .\" Copyright 2013 Darik Horn <dajhorn@vanadac.com>. All rights reserved. | |
| 24 | .\" | |
| 25 | .TH mount.zfs 8 "2013 FEB 28" "ZFS on Linux" "System Administration Commands" | |
| 26 | ||
| 27 | .SH NAME | |
| 28 | mount.zfs \- mount a ZFS filesystem | |
| 29 | .SH SYNOPSIS | |
| 30 | .LP | |
| 31 | .BI "mount.zfs [\-sfnvh] [\-o " options "]" " dataset mountpoint | |
| 32 | ||
| 33 | .SH DESCRIPTION | |
| 34 | .BR mount.zfs | |
| 35 | is part of the zfsutils package for Linux. It is a helper program that | |
| 36 | is usually invoked by the | |
| 37 | .BR mount (8) | |
| 38 | or | |
| 39 | .BR zfs (8) | |
| 40 | commands to mount a ZFS dataset. | |
| 41 | ||
| 42 | All | |
| 43 | .I options | |
| 44 | are handled according to the FILESYSTEM INDEPENDENT MOUNT OPTIONS | |
| 45 | section in the | |
| 46 | .BR mount (8) | |
| 47 | manual, except for those described below. | |
| 48 | ||
| 49 | The | |
| 50 | .I dataset | |
| 51 | parameter is a ZFS filesystem name, as output by the | |
| 52 | .B "zfs list -H -o name | |
| 53 | command. This parameter never has a leading slash character and is | |
| 54 | not a device name. | |
| 55 | ||
| 56 | The | |
| 57 | .I mountpoint | |
| 58 | parameter is the path name of a directory. | |
| 59 | ||
| 60 | ||
| 61 | .SH OPTIONS | |
| 62 | .TP | |
| 63 | .BI "\-s" | |
| 64 | Ignore bad or sloppy mount options. | |
| 65 | .TP | |
| 66 | .BI "\-f" | |
| 67 | Do a fake mount; do not perform the mount operation. | |
| 68 | .TP | |
| 69 | .BI "\-n" | |
| 70 | Do not update the /etc/mtab file. | |
| 71 | .TP | |
| 72 | .BI "\-v" | |
| 73 | Increase verbosity. | |
| 74 | .TP | |
| 75 | .BI "\-h" | |
| 76 | Print the usage message. | |
| 77 | .TP | |
| 78 | .BI "\-o legacy" | |
| 79 | This private flag indicates that the | |
| 80 | .I dataset | |
| 81 | has an entry in the /etc/fstab file. | |
| 82 | .TP | |
| 83 | .BI "\-o noxattr" | |
| 84 | This private flag disables extended attributes. | |
| 85 | .TP | |
| 86 | .BI "\-o xattr | |
| 87 | This private flag enables extended attributes and, if appropriate, | |
| 88 | adds a ZFS context to the selinux system policy. | |
| 89 | .TP | |
| 90 | .BI "\-o zfsutil" | |
| 91 | This private flag indicates that | |
| 92 | .BR mount (8) | |
| 93 | is being called by the | |
| 94 | .BR zfs (8) | |
| 95 | command. | |
| 96 | ||
| 97 | .SH NOTES | |
| 98 | ZFS conventionally requires that the | |
| 99 | .I mountpoint | |
| 100 | be an empty directory, but the Linux implementation inconsistently | |
| 101 | enforces the requirement. | |
| 102 | ||
| 103 | The | |
| 104 | .BR mount.zfs | |
| 105 | helper does not mount the contents of zvols. | |
| 106 | ||
| 107 | .SH FILES | |
| 108 | .TP 18n | |
| 109 | .I /etc/fstab | |
| 110 | The static filesystem table. | |
| 111 | .TP | |
| 112 | .I /etc/mtab | |
| 113 | The mounted filesystem table. | |
| 114 | .SH "AUTHORS" | |
| 115 | The primary author of | |
| 116 | .BR mount.zfs | |
| 117 | is Brian Behlendorf <behlendorf1@llnl.gov>. | |
| 118 | ||
| 119 | This man page was written by Darik Horn <dajhorn@vanadac.com>. | |
| 120 | .SH "SEE ALSO" | |
| 121 | .BR fstab (5), | |
| 122 | .BR mount (8), | |
| 123 | .BR zfs (8) |