]>
git.proxmox.com Git - mirror_zfs.git/blob - cmd/mount_zfs/mount_zfs.c
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
23 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Copyright (c) 2011 Lawrence Livermore National Security, LLC.
30 #include <sys/mount.h>
31 #include <sys/mntent.h>
40 #define ZS_COMMENT 0x00000000 /* comment */
41 #define ZS_ZFSUTIL 0x00000001 /* caller is zfs(8) */
43 libzfs_handle_t
*g_zfs
;
46 * Opportunistically convert a target string into a pool name. If the
47 * string does not represent a block device with a valid zfs label
48 * then it is passed through without modification.
51 parse_dataset(const char *target
, char **dataset
)
54 * Prior to util-linux 2.36.2, if a file or directory in the
55 * current working directory was named 'dataset' then mount(8)
56 * would prepend the current working directory to the dataset.
57 * Check for it and strip the prepended path when it is added.
60 if (getcwd(cwd
, PATH_MAX
) == NULL
) {
64 int len
= strlen(cwd
);
65 if (strncmp(cwd
, target
, len
) == 0)
68 /* Assume pool/dataset is more likely */
69 strlcpy(*dataset
, target
, PATH_MAX
);
71 int fd
= open(target
, O_RDONLY
| O_CLOEXEC
);
76 if (zpool_read_label(fd
, &cfg
, NULL
) == 0) {
78 if (!nvlist_lookup_string(cfg
, ZPOOL_CONFIG_POOL_NAME
, &nm
))
79 strlcpy(*dataset
, nm
, PATH_MAX
);
88 * Update the mtab_* code to use the libmount library when it is commonly
89 * available otherwise fallback to legacy mode. The mount(8) utility will
90 * manage the lock file for us to prevent racing updates to /etc/mtab.
93 mtab_is_writeable(void)
98 error
= lstat("/etc/mtab", &st
);
99 if (error
|| S_ISLNK(st
.st_mode
))
102 fd
= open("/etc/mtab", O_RDWR
| O_CREAT
, 0644);
111 mtab_update(char *dataset
, char *mntpoint
, char *type
, char *mntopts
)
117 mnt
.mnt_fsname
= dataset
;
118 mnt
.mnt_dir
= mntpoint
;
120 mnt
.mnt_opts
= mntopts
? mntopts
: "";
124 fp
= setmntent("/etc/mtab", "a+");
126 (void) fprintf(stderr
, gettext(
127 "filesystem '%s' was mounted, but /etc/mtab "
128 "could not be opened due to error: %s\n"),
129 dataset
, strerror(errno
));
130 return (MOUNT_FILEIO
);
133 error
= addmntent(fp
, &mnt
);
135 (void) fprintf(stderr
, gettext(
136 "filesystem '%s' was mounted, but /etc/mtab "
137 "could not be updated due to error: %s\n"),
138 dataset
, strerror(errno
));
139 return (MOUNT_FILEIO
);
142 (void) endmntent(fp
);
144 return (MOUNT_SUCCESS
);
148 main(int argc
, char **argv
)
151 char prop
[ZFS_MAXPROPLEN
];
152 uint64_t zfs_version
= 0;
153 char mntopts
[MNT_LINE_MAX
] = { '\0' };
154 char badopt
[MNT_LINE_MAX
] = { '\0' };
155 char mtabopt
[MNT_LINE_MAX
] = { '\0' };
156 char mntpoint
[PATH_MAX
];
157 char dataset
[PATH_MAX
], *pdataset
= dataset
;
158 unsigned long mntflags
= 0, zfsflags
= 0, remount
= 0;
159 int sloppy
= 0, fake
= 0, verbose
= 0, nomtab
= 0, zfsutil
= 0;
162 (void) setlocale(LC_ALL
, "");
163 (void) setlocale(LC_NUMERIC
, "C");
164 (void) textdomain(TEXT_DOMAIN
);
169 while ((c
= getopt_long(argc
, argv
, "sfnvo:h?", 0, 0)) != -1) {
184 (void) strlcpy(mntopts
, optarg
, sizeof (mntopts
));
189 (void) fprintf(stderr
,
190 gettext("Invalid option '%c'\n"), optopt
);
191 (void) fprintf(stderr
, gettext("Usage: mount.zfs "
192 "[-sfnvh] [-o options] <dataset> <mountpoint>\n"));
193 return (MOUNT_USAGE
);
200 /* check that we only have two arguments */
203 (void) fprintf(stderr
, gettext("missing dataset "
206 (void) fprintf(stderr
,
207 gettext("missing mountpoint argument\n"));
209 (void) fprintf(stderr
, gettext("too many arguments\n"));
210 (void) fprintf(stderr
, "usage: mount <dataset> <mountpoint>\n");
211 return (MOUNT_USAGE
);
214 parse_dataset(argv
[0], &pdataset
);
216 /* canonicalize the mount point */
217 if (realpath(argv
[1], mntpoint
) == NULL
) {
218 (void) fprintf(stderr
, gettext("filesystem '%s' cannot be "
219 "mounted at '%s' due to canonicalization error: %s\n"),
220 dataset
, argv
[1], strerror(errno
));
221 return (MOUNT_SYSERR
);
224 /* validate mount options and set mntflags */
225 error
= zfs_parse_mount_options(mntopts
, &mntflags
, &zfsflags
, sloppy
,
230 (void) fprintf(stderr
, gettext("filesystem '%s' "
231 "cannot be mounted due to a memory allocation "
232 "failure.\n"), dataset
);
233 return (MOUNT_SYSERR
);
235 (void) fprintf(stderr
, gettext("filesystem '%s' "
236 "cannot be mounted due to invalid option "
237 "'%s'.\n"), dataset
, badopt
);
238 (void) fprintf(stderr
, gettext("Use the '-s' option "
239 "to ignore the bad mount option.\n"));
240 return (MOUNT_USAGE
);
242 (void) fprintf(stderr
, gettext("filesystem '%s' "
243 "cannot be mounted due to internal error %d.\n"),
245 return (MOUNT_SOFTWARE
);
249 if (mntflags
& MS_REMOUNT
) {
254 if (zfsflags
& ZS_ZFSUTIL
)
257 if ((g_zfs
= libzfs_init()) == NULL
) {
258 (void) fprintf(stderr
, "%s\n", libzfs_error_init(errno
));
259 return (MOUNT_SYSERR
);
262 /* try to open the dataset to access the mount point */
263 if ((zhp
= zfs_open(g_zfs
, dataset
,
264 ZFS_TYPE_FILESYSTEM
| ZFS_TYPE_SNAPSHOT
)) == NULL
) {
265 (void) fprintf(stderr
, gettext("filesystem '%s' cannot be "
266 "mounted, unable to open the dataset\n"), dataset
);
268 return (MOUNT_USAGE
);
271 if (!zfsutil
|| sloppy
||
272 libzfs_envvar_is_set("ZFS_MOUNT_HELPER")) {
273 zfs_adjust_mount_options(zhp
, mntpoint
, mntopts
, mtabopt
);
276 /* treat all snapshots as legacy mount points */
277 if (zfs_get_type(zhp
) == ZFS_TYPE_SNAPSHOT
)
278 (void) strlcpy(prop
, ZFS_MOUNTPOINT_LEGACY
, ZFS_MAXPROPLEN
);
280 (void) zfs_prop_get(zhp
, ZFS_PROP_MOUNTPOINT
, prop
,
281 sizeof (prop
), NULL
, NULL
, 0, B_FALSE
);
284 * Fetch the max supported zfs version in case we get ENOTSUP
285 * back from the mount command, since we need the zfs handle
288 zfs_version
= zfs_prop_get_int(zhp
, ZFS_PROP_VERSION
);
289 if (zfs_version
== 0) {
290 fprintf(stderr
, gettext("unable to fetch "
291 "ZFS version for filesystem '%s'\n"), dataset
);
294 return (MOUNT_SYSERR
);
298 * Legacy mount points may only be mounted using 'mount', never using
299 * 'zfs mount'. However, since 'zfs mount' actually invokes 'mount'
300 * we differentiate the two cases using the 'zfsutil' mount option.
301 * This mount option should only be supplied by the 'zfs mount' util.
303 * The only exception to the above rule is '-o remount' which is
304 * always allowed for non-legacy datasets. This is done because when
305 * using zfs as your root file system both rc.sysinit/umountroot and
306 * systemd depend on 'mount -o remount <mountpoint>' to work.
308 if (zfsutil
&& (strcmp(prop
, ZFS_MOUNTPOINT_LEGACY
) == 0)) {
309 (void) fprintf(stderr
, gettext(
310 "filesystem '%s' cannot be mounted using 'zfs mount'.\n"
311 "Use 'zfs set mountpoint=%s' or 'mount -t zfs %s %s'.\n"
312 "See zfs(8) for more information.\n"),
313 dataset
, mntpoint
, dataset
, mntpoint
);
316 return (MOUNT_USAGE
);
319 if (!zfsutil
&& !(remount
|| fake
) &&
320 strcmp(prop
, ZFS_MOUNTPOINT_LEGACY
)) {
321 (void) fprintf(stderr
, gettext(
322 "filesystem '%s' cannot be mounted using 'mount'.\n"
323 "Use 'zfs set mountpoint=%s' or 'zfs mount %s'.\n"
324 "See zfs(8) for more information.\n"),
325 dataset
, "legacy", dataset
);
328 return (MOUNT_USAGE
);
332 (void) fprintf(stdout
, gettext("mount.zfs:\n"
333 " dataset: \"%s\"\n mountpoint: \"%s\"\n"
334 " mountflags: 0x%lx\n zfsflags: 0x%lx\n"
335 " mountopts: \"%s\"\n mtabopts: \"%s\"\n"),
336 dataset
, mntpoint
, mntflags
, zfsflags
, mntopts
, mtabopt
);
339 if (zfsutil
&& !sloppy
&&
340 !libzfs_envvar_is_set("ZFS_MOUNT_HELPER")) {
341 error
= zfs_mount_at(zhp
, mntopts
, mntflags
, mntpoint
);
343 (void) fprintf(stderr
, "zfs_mount_at() failed: "
344 "%s", libzfs_error_description(g_zfs
));
347 return (MOUNT_SYSERR
);
350 error
= mount(dataset
, mntpoint
, MNTTYPE_ZFS
,
361 (void) fprintf(stderr
, gettext("mount point "
362 "'%s' does not exist\n"), mntpoint
);
363 return (MOUNT_SYSERR
);
365 (void) fprintf(stderr
, gettext("filesystem "
366 "'%s' is already mounted\n"), dataset
);
369 if (zfs_version
> ZPL_VERSION
) {
370 (void) fprintf(stderr
,
371 gettext("filesystem '%s' (v%d) is not "
372 "supported by this implementation of "
373 "ZFS (max v%d).\n"), dataset
,
374 (int)zfs_version
, (int)ZPL_VERSION
);
376 (void) fprintf(stderr
,
377 gettext("filesystem '%s' mount "
378 "failed for unknown reason.\n"), dataset
);
380 return (MOUNT_SYSERR
);
383 if (mntflags
& MS_MANDLOCK
) {
384 (void) fprintf(stderr
, gettext("filesystem "
385 "'%s' has the 'nbmand=on' property set, "
386 "this mount\noption may be disabled in "
387 "your kernel. Use 'zfs set nbmand=off'\n"
388 "to disable this option and try to "
389 "mount the filesystem again.\n"), dataset
);
390 return (MOUNT_SYSERR
);
395 (void) fprintf(stderr
, gettext("filesystem "
396 "'%s' can not be mounted: %s\n"), dataset
,
398 return (MOUNT_USAGE
);
402 if (!nomtab
&& mtab_is_writeable()) {
403 error
= mtab_update(dataset
, mntpoint
, MNTTYPE_ZFS
, mtabopt
);
408 return (MOUNT_SUCCESS
);