2N/A * The contents of this file are subject to the terms of the 2N/A * Common Development and Distribution License (the "License"). 2N/A * You may not use this file except in compliance with the License. 2N/A * See the License for the specific language governing permissions 2N/A * and limitations under the License. 2N/A * When distributing Covered Code, include this CDDL HEADER in each 2N/A * If applicable, add the following below this CDDL HEADER, with the 2N/A * fields enclosed by brackets "[]" replaced with your own identifying 2N/A * information: Portions Copyright [yyyy] [name of copyright owner] 2N/A * Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved. 2N/A/* Private function prototypes */ 2N/A/* ******************************************************************** */ 2N/A/* Public Functions */ 2N/A/* ******************************************************************** */ 2N/A * Function: be_mount 2N/A * Description: Mounts a BE and its subordinate datasets at a given mountpoint. 2N/A * be_attrs - pointer to nvlist_t of attributes being passed in. 2N/A * The following attributes are used by this function: 2N/A * BE_ATTR_ORIG_BE_NAME *required 2N/A * BE_ATTR_MOUNTPOINT *required 2N/A * BE_ATTR_ALT_POOL *optional 2N/A * BE_ATTR_MOUNT_FLAGS *optional 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Check to see if we have write access to the root filesystem 2N/A /* Initialize libzfs handle */ 2N/A /* Get original BE name */ 2N/A "BE_ATTR_ORIG_BE_NAME attribute\n"));
2N/A /* Validate original BE name */ 2N/A /* Get mountpoint */ 2N/A "BE_ATTR_MOUNTPOINT attribute\n"));
2N/A /* Get alternate "pool" */ 2N/A "BE_ATTR_ALT_POOL attribute\n"));
2N/A "BE_ATTR_MOUNT_FLAGS attribute\n"));
2N/A * Function: be_unmount 2N/A * Description: Unmounts a BE and its subordinate datasets. 2N/A * be_attrs - pointer to nvlist_t of attributes being passed in. 2N/A * The following attributes are used by this function: 2N/A * BE_ATTR_ORIG_BE_NAME *required 2N/A * BE_ATTR_ALT_POOL *optional 2N/A * BE_ATTR_UNMOUNT_FLAGS *optional 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Check to see if we have write access to the root filesystem 2N/A /* Initialize libzfs handle */ 2N/A /* Get original BE name */ 2N/A "BE_ATTR_ORIG_BE_NAME attribute\n"));
2N/A /* Validate original BE name */ 2N/A /* Get alternate "pool" area */ 2N/A "BE_ATTR_ALT_POOL attribute\n"));
2N/A /* Get unmount flags */ 2N/A "BE_ATTR_UNMOUNT_FLAGS attribute\n"));
2N/A/* ******************************************************************** */ 2N/A/* Semi-Private Functions */ 2N/A/* ******************************************************************** */ 2N/A * Function: _be_mount 2N/A * Description: Mounts a BE. If the altroot is not provided, this function 2N/A * will generate a temporary mountpoint to mount the BE at. It 2N/A * will return this temporary mountpoint to the caller via the 2N/A * altroot reference pointer passed in. This returned value is 2N/A * allocated on heap storage and is the repsonsibility of the 2N/A * be_name - pointer to name of BE to mount. 2N/A * altpool - pointer to alternate "pool" area to find the BE. 2N/A * altroot - reference pointer to altroot of where to mount BE. 2N/A * flags - flag indicating special handling for mounting the BE 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A * Check to see if we're operating inside a Solaris Container 2N/A * or the Global Zone. 2N/A /* Set be_name as obe_name in bt structure */ 2N/A /* Find which zpool obe_name lives in if alternate "pool" not provide */ 2N/A /* Generate string for obe_name's root dataset */ 2N/A /* Get handle to BE's root dataset */ 2N/A /* Make sure BE's root dataset isn't already mounted somewhere */ 2N/A * Fix this BE's mountpoint if its root dataset isn't set to 2N/A * either 'legacy' or '/'. 2N/A * If altroot not provided, create a temporary alternate root 2N/A "make temporary mountpoint\n"));
2N/A /* Mount the BE's root file system */ 2N/A "mount BE root file system\n"));
2N/A /* Iterate through BE's children filesystems */ 2N/A * Mount shared file systems if mount flag says so. 2N/A * Mount all ZFS file systems not under the BE's 2N/A * If we're in the global zone and the global zone has 2N/A * a valid uuid, mount all supported non-global zones. 2N/A * If a NULL altroot was passed in, pass the generated altroot 2N/A * back to the caller in altroot. 2N/A * Function: _be_unmount 2N/A * Description: Unmount a BE. 2N/A * be_name - pointer to name of BE to unmount. 2N/A * altpool - pointer to alternate "pool" area to find the BE. 2N/A * flags - flags for unmounting the BE. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A * Check to see if we're operating inside a Solaris Container 2N/A * or the Global Zone. 2N/A /* Set be_name as obe_name in bt structure */ 2N/A /* Find which zpool obe_name lives in if alternate "pool" not provide */ 2N/A "zpool_iter failed: %s\n"),
2N/A /* Generate string for obe_name's root dataset */ 2N/A /* Get handle to BE's root dataset */ 2N/A /* Make sure BE's root dataset is mounted somewhere */ 2N/A * BE is not mounted, fix this BE's mountpoint if its root 2N/A * dataset isn't set to either 'legacy' or '/'. 2N/A * If we didn't get a mountpoint from the zfs_is_mounted call, 2N/A * try and get it from its property. 2N/A /* If BE mounted as current root, fail */ 2N/A "cannot unmount currently running BE\n"));
2N/A /* Unmount all supported non-global zones if we're in the global zone */ 2N/A /* TODO: Unmount all non-ZFS file systems - Not supported yet */ 2N/A /* Unmount all ZFS file systems not under the BE root dataset */ 2N/A "unmount shared file systems\n"));
2N/A /* Unmount all children datasets under the BE's root dataset */ 2N/A /* Unmount this BE's root filesystem */ 2N/A * Function: be_mount_zone_root 2N/A * Description: Mounts the zone root dataset for a zone. 2N/A * zfs - zfs_handle_t pointer to zone root dataset 2N/A * md - be_mount_data_t pointer to data for zone to be mounted 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A /* Get mountpoint property of dataset */ 2N/A * Make sure zone's root dataset is set to /. The ZFS temporary 2N/A * mountpoint feature is used to mount at the zone root in the 2N/A "zone root dataset mountpoint is not '/'\n"));
2N/A * Check to see if the zone root is already mounted, perhaps 2N/A * within the zone itself. 2N/A "mount zone root dataset %s \nbecause it is " 2N/A "already mounted at %s. This is likely due to " 2N/A "the zone root\nbeing mounted within the zone " 2N/A * Temporary mount the zone root dataset. 2N/A "temporary mount zone root dataset (%s) at %s\n"),
2N/A * Function: be_unmount_zone_root 2N/A * Description: Unmounts the zone root dataset for a zone. 2N/A * zhp - zfs_handle_t pointer to zone root dataset 2N/A * ud - be_unmount_data_t pointer to data for zone to be unmounted 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wise use only) 2N/A /* Unmount the dataset */ 2N/A /* Get the current mountpoint property for the zone root dataset */ 2N/A "get mountpoint property for zone root dataset (%s): %s\n"),
2N/A /* If mountpoint not already set to '/', set it to '/' */ 2N/A "failed to set mountpoint of zone root dataset " 2N/A * Function: be_get_legacy_fs 2N/A * Description: This function iterates through all non-shared file systems 2N/A * of a BE and finds the ones with a legacy mountpoint. For 2N/A * those file systems, it reads the BE's vfstab to get the 2N/A * mountpoint. If found, it adds that file system to the 2N/A * be_fs_list_data_t passed in. 2N/A * This function can be used to gather legacy mounted file systems 2N/A * for both global BEs and non-global zone BEs. To get data for 2N/A * a non-global zone BE, the zoneroot_ds and zoneroot parameters 2N/A * will be specified, otherwise they should be set to NULL. 2N/A * be_name - global BE name from which to get legacy file 2N/A * be_root_ds - root dataset of global BE. 2N/A * zoneroot_ds - root dataset of zone. 2N/A * zoneroot - zoneroot path of zone. 2N/A * fld - be_fs_list_data_t pointer. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A /* Get handle to BE's root dataset */ 2N/A /* If BE is not already mounted, mount it. */ 2N/A "get altroot of mounted BE %s: %s\n"),
2N/A * If a zone root dataset was passed in, we're wanting to get 2N/A * legacy mounted file systems for that zone, not the global 2N/A /* Close off handle to global BE's root dataset */ 2N/A /* Get handle to zone's root dataset */ 2N/A "open zone BE root dataset (%s): %s\n"),
2N/A /* Make sure the zone we're looking for is mounted */ 2N/A /* Generate alternate root path for zone */ 2N/A "memory allocation failed\n"));
2N/A "failed to mount zone root %s\n"),
2N/A * If the root dataset is in the vfstab with a mountpoint of "/", 2N/A * add it to the list 2N/A "failed to add %s to fs list\n"),
2N/A /* Iterate subordinate file systems looking for legacy mounts */ 2N/A "failed to iterate %s to get legacy mounts\n"),
2N/A /* If we mounted the zone BE, unmount it */ 2N/A "failed to unmount zone root %s\n"),
2N/A /* If we mounted this BE, unmount it */ 2N/A * Function: be_free_fs_list 2N/A * Description: Function used to free the members of a be_fs_list_data_t 2N/A * fld - be_fs_list_data_t pointer to free. 2N/A * Semi-private (library wide use only) 2N/A * Function: be_get_ds_from_dir(char *dir) 2N/A * Description: Given a directory path, find the underlying dataset mounted 2N/A * at that directory path if there is one. The returned name 2N/A * is allocated in heap storage, so the caller is responsible 2N/A * dir - char pointer of directory to find. 2N/A * NULL - if directory is not mounted from a dataset. 2N/A * name of dataset mounted at dir. 2N/A * Semi-private (library wide use only) 2N/A /* Make sure length of dir is within the max length */ 2N/A /* Resolve dir in case its lofs mounted */ 2N/A * Function: be_make_tmp_mountpoint 2N/A * Description: This function generates a random temporary mountpoint 2N/A * and creates that mountpoint directory. It returns the 2N/A * mountpoint in heap storage, so the caller is responsible 2N/A * tmp_mp - reference to pointer of where to store generated 2N/A * temporary mountpoint. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A "malloc failed\n"));
2N/A * Function: be_tmp_mount_ds 2N/A * Description: This function will temporarily mount a dataset on a randomly 2N/A * generated tmp mountpoint. 2N/A * zhp - handle to the dataset to mount. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Semi-private (library wide use only) 2N/A /* Dataset already mounted, return success */ 2N/A * Attempt to mount on a temp mountpoint 2N/A "to make temporary mountpoint\n"));
2N/A /* Temporarily mount this filesystem */ 2N/A/* ******************************************************************** */ 2N/A/* Private Functions */ 2N/A/* ******************************************************************** */ 2N/A * Function: be_mount_callback 2N/A * Description: Callback function used to iterate through all of a BE's 2N/A * subordinate file systems and to mount them accordingly. 2N/A * zhp - zfs_handle_t pointer to current file system being 2N/A * data - pointer to the altroot of where to mount BE. 2N/A * be_errno_t - Failure 2N/A /* Get dataset's persistent mountpoint and source values */ 2N/A "get mountpoint and sourcetype for %s\n"),
2N/A * Set this filesystem's 'canmount' property to 'noauto' just incase 2N/A * it's been set 'on'. We do this so that when we change its 2N/A * mountpoint zfs won't immediately try to mount it. 2N/A * If the mountpoint is none, there's nothing to do, goto next. 2N/A * If the mountpoint is legacy, legacy mount it with mount(2). 2N/A * If the mountpoint is inherited, its mountpoint should 2N/A * already be set. If it's not, then explicitly fix-up 2N/A * the mountpoint now by appending its explicitly set 2N/A * mountpoint value to the BE mountpoint. 2N/A * If the mountpoint is set to 'legacy', we need to 2N/A * dig into this BE's vfstab to figure out where to 2N/A * mount it, and just mount it via mount(2) relative 2N/A /* Legacy mount the file system */ 2N/A "failed to mount %s on %s\n"),
2N/A "no entry for %s in vfstab, " 2N/A * Else process dataset mountpoint property relative to altroot. 2N/A "mountpoint sourcetype of %s is %d, skipping ...\n"),
2N/A * Check to see if the mountpoint we need to mount at 2N/A * exists and if not, create it. 2N/A /* Temporarily mount this filesystem */ 2N/A /* Iterate through this dataset's children and mount them */ 2N/A * Function: be_unmount_callback 2N/A * Description: Callback function used to iterate through all of a BE's 2N/A * subordinate file systems and to unmount them. 2N/A * zhp - zfs_handle_t pointer to current file system being 2N/A * data - pointer to the mountpoint of where BE is mounted. 2N/A * be_errno_t - Failure 2N/A /* Iterate down this dataset's children first */ 2N/A /* Is dataset even mounted ? */ 2N/A /* Unmount this file system */ 2N/A /* Set this filesystem's 'canmount' property to 'noauto' */ 2N/A "failed to set canmount to 'noauto' (%s)\n"),
fs_name);
2N/A * Function: be_get_legacy_fs_callback 2N/A * Description: The callback function is used to iterate through all 2N/A * non-shared file systems of a BE, finding ones that have 2N/A * a legacy mountpoint and an entry in the BE's vfstab. 2N/A * It adds these file systems to the callback data. 2N/A * zhp - zfs_handle_t pointer to current file system being 2N/A * data - be_fs_list_data_t pointer 2N/A * be_errno_t - Failure 2N/A /* Get this dataset's persistent mountpoint property */ 2N/A "failed to get mountpoint for %s: %s\n"),
2N/A * If mountpoint is legacy, try to get its mountpoint from this BE's 2N/A * vfstab. If it exists in the vfstab, add this file system to the 2N/A "no entry for %s in vfstab, " 2N/A /* Record file system into the callback data. */ 2N/A /* Iterate through this dataset's children file systems */ 2N/A * Function: add_to_fs_list 2N/A * Description: Function used to add a file system to the fs_list array in 2N/A * a be_fs_list_data_t structure. 2N/A * fld - be_fs_list_data_t pointer 2N/A * fs - file system to add 2N/A * BE_SUCCESS - Success 2N/A "memory allocation failed\n"));
2N/A "memory allocation failed\n"));
2N/A * Function: zpool_shared_fs_callback 2N/A * Description: Callback function used to iterate through all existing pools 2N/A * to find and mount all shared filesystems. This function 2N/A * processes the pool's "pool data" dataset, then uses 2N/A * iter_shared_fs_callback to iterate through the pool's 2N/A * zlp - zpool_handle_t pointer to the current pool being 2N/A * data - be_mount_data_t pointer 2N/A * be_errno_t - Failure 2N/A * Get handle to pool's "pool data" dataset 2N/A "failed to open pool dataset %s: %s\n"),
zpool,
2N/A /* Process this pool's "pool data" dataset */ 2N/A /* Interate through this pool's children */ 2N/A * Function: iter_shared_fs_callback 2N/A * Description: Callback function used to iterate through a pool's datasets 2N/A * to find and mount all shared filesystems. It makes sure to 2N/A * find the BE container dataset of the pool, if it exists, and 2N/A * does not process and iterate down that path. 2N/A * Note - This function iterates linearly down the 2N/A * hierarchical dataset paths and mounts things as it goes 2N/A * along. It does not make sure that something deeper down 2N/A * a dataset path has an interim mountpoint for something 2N/A * processed earlier. 2N/A * zhp - zfs_handle_t pointer to the current dataset being 2N/A * data - be_mount_data_t pointer 2N/A * be_errno_t - Failure 2N/A /* Get the pool's name */ 2N/A /* Get the name of this pool's container dataset */ 2N/A * If what we're processing is this pool's BE container 2N/A /* Getting the pool name failed, return error */ 2N/A "failed to get pool name from %s\n"),
name);
2N/A /* Mount this shared filesystem */ 2N/A /* Iterate this dataset's children file systems */ 2N/A * Function: loopback_mount_shared_fs 2N/A * Description: This function loopback mounts a file system into the altroot 2N/A * area of the BE being mounted. Since these are shared file 2N/A * systems, they are expected to be already mounted for the 2N/A * current BE, and this function just loopback mounts them into 2N/A * the BE mountpoint. If they are not mounted for the current 2N/A * live system, they are skipped and not mounted into the BE 2N/A * zhp - zfs_handle_t pointer to the dataset to loopback mount 2N/A * md - be_mount_data_t pointer 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Check if file system is currently mounted and not delegated 2N/A * to a non-global zone (if we're in the global zone) 2N/A * If we didn't get a mountpoint from the zfs_is_mounted call, 2N/A * get it from the mountpoint property. 2N/A "failed to get mountpoint property\n"));
2N/A /* Mount it read-only if read-write was not requested */ 2N/A /* Add the "nosub" option to the mount options string */ 2N/A /* Loopback mount this dataset at the altroot */ 2N/A "failed to loopback mount %s at %s: %s\n"),
2N/A * Function: loopback_mount_zonepath 2N/A * Description: This function loopback mounts a zonepath into the altroot 2N/A * area of the BE being mounted. Since these are shared file 2N/A * systems, they are expected to be already mounted for the 2N/A * current BE, and this function just loopback mounts them into 2N/A * the BE mountpoint. 2N/A * zonepath - pointer to zone path in the current BE 2N/A * md - be_mount_data_t pointer 2N/A * use_tmpfs - mount using tmpfs instead of lofs 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * before attempting the loopback mount of zonepath under altroot, 2N/A * we need to make sure that all intermediate file systems in the 2N/A * zone path are also mounted under altroot 2N/A /* get the parent directory for zonepath */ 2N/A "failed to stat %s"),
2N/A * After the above stat call, st.st_dev contains ID of the 2N/A * device over which parent dir resides. 2N/A * Now, search mnttab and find mount point of parent dir device. 2N/A (*(
p1 +
5) !=
'/' && *(
p1 +
5) !=
'\0')) {
2N/A * if parent dir is in a shared file 2N/A * system, check whether it is already 2N/A * loopback mounted under altroot or 2N/A * not. It would have been mounted 2N/A * already under altroot if it is in 2N/A * a non-shared filesystem. 2N/A /* Add the "nosub" option to the mount options string */ 2N/A "failed to tmpfs mount zone path %s\n"),
2N/A * We need to fixup the permissions for the zonepath 2N/A * we just mounted in the altroot so that the zoneroot 2N/A * isn't available to everyone on the system 2N/A "failed to chmod zone path %s\n"),
2N/A /* Loopback mount this dataset at the altroot */ 2N/A "failed to loopback mount %s at %s: %s\n"),
2N/A * Function: unmount_shared_fs 2N/A * Description: This function iterates through the mnttab and finds all 2N/A * loopback mount entries that reside within the altroot of 2N/A * where the BE is mounted, and unmounts it. 2N/A * ud - be_unmount_data_t pointer 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A /* Read in the mnttab into a table */ 2N/A "failed to open mnttab\n"));
2N/A * Copy over the current mnttab entry into our table, 2N/A * copying only the fields that we care about. 2N/A "memory allocation failed\n"));
2N/A * Process the mnttab entries in reverse order, looking for 2N/A * loopback mount entries mounted under our altroot. 2N/A /* If not of type lofs, skip */ 2N/A /* If inside the altroot, unmount it */ 2N/A "unmount_shared_fs: " 2N/A "failed to unmount shared file " 2N/A * Function: get_mountpoint_from_vfstab 2N/A * Description: This function digs into the vfstab in the given altroot, 2N/A * and searches for an entry for the fs passed in. If found, 2N/A * it returns the mountpoint of that fs in the mountpoint 2N/A * buffer passed in. If the get_alt_mountpoint flag is set, 2N/A * it returns the mountpoint with the altroot prepended. 2N/A * altroot - pointer to the alternate root location 2N/A * fs - pointer to the file system name to look for in the 2N/A * mountpoint - pointer to buffer of where the mountpoint of 2N/A * fs will be returned. 2N/A * size_mp - size of mountpoint argument 2N/A * get_alt_mountpoint - flag to indicate whether or not the 2N/A * mountpoint should be populated with the altroot 2N/A * BE_SUCCESS - Success 2N/A /* Generate path to alternate root vfstab */ 2N/A /* Open alternate root vfstab */ 2N/A * Found entry for fs, grab its mountpoint. 2N/A * If the flag to prepend the altroot into the mountpoint 2N/A * is set, prepend it. Otherwise, just return the mountpoint. 2N/A * Function: fix_mountpoint_callback 2N/A * Description: This callback function is used to iterate through a BE's 2N/A * children filesystems to check if its mountpoint is currently 2N/A * set to be mounted at some specified altroot. If so, fix it by 2N/A * removing altroot from the beginning of its mountpoint. 2N/A * Note - There's no way to tell if a child filesystem's 2N/A * mountpoint isn't broken, and just happens to begin with 2N/A * the altroot we're looking for. In this case, this function 2N/A * will errantly remove the altroot portion from the beginning 2N/A * of this filesystem's mountpoint. 2N/A * zhp - zfs_handle_t pointer to filesystem being processed. 2N/A * data - altroot of where BE is to be mounted. 2N/A * be_errno_t - Failure 2N/A /* Get dataset's persistent mountpoint and source values */ 2N/A "failed to get mountpoint and sourcetype for %s\n"),
2N/A * If the mountpoint is not inherited and the mountpoint is not 2N/A * 'legacy', this file system potentially needs its mountpoint 2N/A * Check if this file system's current mountpoint is 2N/A * under the altroot we're fixing it against. 2N/A * Get this dataset's mountpoint relative to the 2N/A /* Fix this dataset's mountpoint value */ 2N/A "failed to set mountpoint for %s to " 2N/A /* Iterate through this dataset's children and fix them */ 2N/A * Function: be_mount_root 2N/A * Description: This function mounts the root dataset of a BE at the 2N/A * specified altroot. 2N/A * zhp - zfs_handle_t pointer to root dataset of a BE that is 2N/A * to be mounted at altroot. 2N/A * altroot - location of where to mount the BE root. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Check to see if the mountpoint we've been given exists and if 2N/A /* Temporary mount the BE's root filesystem */ 2N/A * Function: be_unmount_root 2N/A * Description: This function unmounts the root dataset of a BE, but before 2N/A * unmounting, it looks at the BE's vfstab to determine 2N/A * if the root dataset mountpoint should be left as 'legacy' 2N/A * or '/'. If the vfstab contains an entry for this root 2N/A * dataset with a mountpoint of '/', it sets the mountpoint 2N/A * property to 'legacy'. 2N/A * zhp - zfs_handle_t pointer of the BE root dataset that 2N/A * is currently mounted. 2N/A * ud - be_unmount_data_t pointer providing unmount data 2N/A * for the given BE root dataset. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A /* See if this is a legacy mounted root */ 2N/A /* Unmount the dataset */ 2N/A /* Set canmount property for this BE's root filesystem to noauto */ 2N/A "set canmount property for %s to 'noauto': %s\n"),
2N/A * Set mountpoint for BE's root dataset back to '/', or 'legacy' 2N/A * if its a legacy mounted root. 2N/A * Function: fix_mountpoint 2N/A * Description: This function checks the mountpoint of an unmounted BE to make 2N/A * sure that it is set to either 'legacy' or '/'. If it's not, 2N/A * then we're in a situation where an unmounted BE has some random 2N/A * mountpoint set for it. (This could happen if the system was 2N/A * rebooted while an inactive BE was mounted). This function 2N/A * attempts to fix its mountpoints. 2N/A * zhp - zfs_handle_t pointer to root dataset of the BE 2N/A * whose mountpoint needs to be checked. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A * Record what this BE's root dataset mountpoint property is currently 2N/A * If the root dataset mountpoint is set to 'legacy' or '/', we're okay. 2N/A * Iterate through this BE's children datasets and fix 2N/A * them if they need fixing. 2N/A * The process of mounting and unmounting the root file system 2N/A * will fix its mountpoint to correctly be either 'legacy' or '/' 2N/A * since be_unmount_root will do the right thing by looking at 2N/A /* Generate temporary altroot to mount the root file system */ 2N/A "make temporary mountpoint\n"));
2N/A /* Mount and unmount the root. */ 2N/A "mount BE root file system\n"));
2N/A "unmount BE root file system\n"));
2N/A * Function: be_mount_zones 2N/A * Description: This function finds all supported non-global zones in the 2N/A * given global BE and mounts them with respect to where the 2N/A * global BE is currently mounted. The global BE datasets 2N/A * (including its shared datasets) are expected to already 2N/A * be_zhp - zfs_handle_t pointer to the root dataset of the 2N/A * md - be_mount_data_t pointer to data for global BE. 2N/A * be_name - name of the BE. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A "no supported brands\n"));
2N/A * Get the dataset of this zonepath in current BE. 2N/A * If not a dataset or otherwise not available skip it 2N/A * but do not fail the BE operation. 2N/A "failed to mount zone %s under altroot " 2N/A "%s.\npkg(1) operations which attempt to " 2N/A "modify ABE %s may fail\nUse 'zoneadm -R" 2N/A "%s -z %s mark unavailable' to manually " 2N/A "mark the zone as unavailable.\n"),
2N/A * Check if this zone is supported based on 2N/A * the dataset of its zonepath 2N/A * if BE's shared file systems are already mounted, 2N/A * zone path dataset would have already been lofs 2N/A * mounted under altroot. Otherwise, we need to do 2N/A /* Mount this zone */ 2N/A "failed to mount zone %s under " 2N/A * libinstzones caches mnttab and uses cached version for resolving lofs 2N/A * mounts when we call z_resolve_lofs. It creates the cached version 2N/A * when the first call to z_resolve_lofs happens. So, library's cached 2N/A * mnttab doesn't contain entries for lofs mounts created in the above 2N/A * loop. Because of this, subsequent calls to z_resolve_lofs would fail 2N/A * to resolve these lofs mounts. So, here we destroy library's cached 2N/A * mnttab to force its recreation when the next call to z_resolve_lofs 2N/A * Function: be_unmount_zones 2N/A * Description: This function finds all supported non-global zones in the 2N/A * given mounted global BE and unmounts them. 2N/A * ud - unmount_data_t pointer data for the global BE. 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A "no supported brands\n"));
2N/A /* Build zone's zonepath wrt the global BE altroot */ 2N/A * Get the dataset of the zonepath. If its not 2N/A * a dataset, skip it. 2N/A * Since the alternate zone path is a tmpfs 2N/A * mount we need to look for the zonepath 2N/A * dataset based on the zonepath not the 2N/A * Check if this zone is supported based on the 2N/A * dataset of its zonepath. 2N/A /* Unmount this zone */ 2N/A " failed to unmount zone %s from " 2N/A * Function: be_mount_one_zone 2N/A * Description: This function is called to mount one zone for a given 2N/A * be_zhp - zfs_handle_t pointer to the root dataset of the 2N/A * md - be_mount_data_t pointer to data for global BE 2N/A * zonename - name of zone to mount 2N/A * zonepath - zonepath of zone to mount 2N/A * zonepath_ds - dataset for the zonepath 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A /* Find the active zone root dataset for this zone for this BE */ 2N/A "find active zone root for zone %s, skipping ...\n"),
2N/A /* Get handle to active zoneroot dataset */ 2N/A /* Generate string for zone's altroot path */ 2N/A /* Build mount_data for the zone */ 2N/A /* Mount the zone's root file system */ 2N/A /* Iterate through zone's children filesystems */ 2N/A "mount zone subordinate file systems at %s\n"),
2N/A /* TODO: Mount all shared file systems for this zone */ 2N/A * Function: be_unmount_one_zone 2N/A * Description: This function unmount one zone for a give global BE. 2N/A * ud - be_unmount_data_t pointer to data for global BE 2N/A * zonename - name of zone to unmount 2N/A * zonepath - zonepath of the zone to unmount 2N/A * zonepath_ds - dataset for the zonepath 2N/A * BE_SUCCESS - Success 2N/A * be_errno_t - Failure 2N/A /* Generate string for zone's alternate root path */ 2N/A /* Generate string for zone's alternate zone path */ 2N/A /* Build be_unmount_data for zone */ 2N/A /* Find the mounted zone root dataset for this zone for this BE */ 2N/A "find any zone root mounted for zone %s\n"),
zonename);
2N/A /* Get handle to zoneroot dataset mounted for this BE */ 2N/A /* TODO: Unmount all shared file systems for this zone */ 2N/A /* Iterate through zone's children filesystems and unmount them */ 2N/A "unmount zone subordinate file systems at %s\n"),
2N/A /* Unmount the zone's root filesystem */ 2N/A * We want to unmount this here since we mounted this as a tmpfs mount 2N/A * in our zone mount code. 2N/A * Check to see if zonepath unmount generated EINVAL which 2N/A * indicates that the zonepath we're trying to unmount was 2N/A * never in fact mounted (because we mount zones in a for-loop 2N/A * but if any individual zone mount encounters an error we stop 2N/A * processing). In which case, just move along. 2N/A * Function: be_get_ds_from_dir_callback 2N/A * Description: This is a callback function used to iterate all datasets 2N/A * to find the one that is currently mounted at the directory 2N/A * being searched for. If matched, the name of the dataset is 2N/A * returned in heap storage, so the caller is responsible for 2N/A * zhp - zfs_handle_t pointer to current dataset being processed. 2N/A * data - dir_data_t pointer providing name of directory being 2N/A * 1 - This dataset is mounted at directory being searched for. 2N/A * 0 - This dataset is not mounted at directory being searched for. 2N/A "memory allocation failed\n"));