[omvzfs.git] / src / Utils.php

<?php
require_once("Exception.php");
require_once("openmediavault/util.inc");
require_once("Dataset.php");
require_once("Zvol.php");
require_once("Vdev.php");
require_once("Zpool.php");

/**
 * Helper class for ZFS module
 */
class OMVModuleZFSUtil {

	/**
	 * Manages relocation of ZFS filesystem mountpoints in the OMV backend.
	 * Needed when the user changes mountpoint of a filesystem in the GUI.
	 *
	 */
	public static function relocateFilesystem($name) {
		global $xmlConfig;
		$poolname = OMVModuleZFSUtil::getPoolname($name);
		$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
		$ds = new OMVModuleZFSDataset($name);
		$dir = $ds->getMountPoint();
		$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
		$object = $xmlConfig->get($xpath);
		$object['dir'] = $property['value'];
		$xmlConfig->replace($xpath, $object);
		return null;
	}
	
	/**
	 * Clears all ZFS labels on specified devices.
	 * Needed for blkid to display proper data.
	 *
	 */
	public static function clearZFSLabel($disks) {
		foreach ($disks as $disk) {
			$cmd = "zpool labelclear /dev/" . $disk . "1";
			OMVModuleZFSUtil::exec($cmd,$out,$res);
		}
		return null;
	}

	/**
	 * Return all disks in /dev/sdXX used by the pool
	 *
	 * @return array An array with all the disks
	 */
	public static function getDevDisksByPool($name) {
		$pool = new OMVModuleZFSZpool($name);
		$disks = array();
		$vdevs = $pool->getVdevs();
		foreach ($vdevs as $vdev) {
			$vdisks = $vdev->getDisks();
			foreach ($vdisks as $vdisk) {
				if (preg_match('/^[a-z0-9]+$/', $vdisk)) {
					$disks[] = $vdisk;
					continue;
				}
				$cmd = "ls -la /dev/disk/by-path/" . $vdisk;
				unset($out);
				OMVModuleZFSUtil::exec($cmd,$out,$res);
				if (count($out) === 1) {
					if (preg_match('/^.*\/([a-z0-9]+)$/', $out[0], $match)) {
						$disks[] = $match[1];
					}
				}
			}
		}
		return($disks);
	}

	/**
	 * Deletes all shared folders pointing to the specifc path
	 *
	 */
	public static function deleteShares($name) {
		global $xmlConfig;
		$poolname = OMVModuleZFSUtil::getPoolname($name);
		$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
		$ds = new OMVModuleZFSDataset($name);
		$dir = $ds->getMountPoint();
		$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
		$mountpoint = $xmlConfig->get($xpath);
		$mntentuuid = $mountpoint['uuid'];
		$xpath = "//system/shares/sharedfolder[mntentref='" . $mntentuuid . "']";
		$objects = $xmlConfig->getList($xpath);
		foreach ($objects as $object) {
			$tmpxpath = sprintf("//*[contains(name(),'sharedfolderref')]".
				"[contains(.,'%s')]", $object['uuid']);
			if ($xmlConfig->exists($tmpxpath)) {
				throw new OMVModuleZFSException("The Filesystem is shared and in use. Please delete all references and try again.");
			}
		}
		$xmlConfig->delete($xpath);
		$dispatcher = &OMVNotifyDispatcher::getInstance();
		$dispatcher->notify(OMV_NOTIFY_DELETE,"org.openmediavault.system.shares.sharedfolder",$object);
	}

	/**
	 * Get the relative path by complete path
	 *
	 * @return string Relative path of the complet path
	 */
	public static function getReldirpath($path) {
 		$subdirs = preg_split('/\//',$path);
		$reldirpath = "";
		for ($i=2;$i<count($subdirs);$i++) {
			$reldirpath .= $subdirs[$i] . "/";
		}
		return(rtrim($reldirpath, "/"));

	}

	/**
	 * Get /dev/disk/by-path from /dev/sdX
	 *
	 * @return string Disk identifier
	 */
	public static function getDiskPath($disk) {
		preg_match("/^.*\/([A-Za-z0-9]+)$/", $disk, $identifier);
		$cmd = "ls -la /dev/disk/by-path | grep '$identifier[1]$'";
		OMVModuleZFSUtil::exec($cmd, $out, $res);
		if (is_array($out)) {
			$cols = preg_split('/[\s]+/', $out[0]);
			return($cols[count($cols)-3]);
		}
	}


	/**
	 * Get poolname from name of dataset/volume etc.
	 *
	 * @return string Name of the pool
	 */
	public static function getPoolname($name) {
		$tmp = preg_split('/[\/]+/', $name);
		return($tmp[0]);
	}

	/**
	 * Get UUID of ZFS pool by name
	 *
	 * @return string UUID of the pool
	 */
	public static function getUUIDbyName($poolname) {
		$cmd = "zpool get guid " . $poolname . " 2>&1";
		OMVModuleZFSUtil::exec($cmd, $out, $res);
		if (isset($out)) {
			$headers = preg_split('/[\s]+/', $out[0]);
			for ($i=0; $i<count($headers); $i++) {
				if (strcmp($headers[$i], "VALUE") === 0) {
					$valuecol=$i;
					break;
				}
			}
			$line = preg_split('/[\s]+/', $out[1]);
			return $line[$valuecol];
		}
		return null;
	}

	/**
	 * Add any missing ZFS filesystems to the OMV backend
	 *
	 */
	public static function addMissingOMVMntEnt() {
		global $xmlConfig;
		$cmd = "zfs list -H -o name -t filesystem";
		OMVModuleZFSUtil::exec($cmd, $out, $res);
		foreach($out as $name) {
			if (preg_match('/[\/]+/', $name)) {
				$poolname = OMVModuleZFSUtil::getPoolname($name);
				$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
				$ds = new OMVModuleZFSDataset($name);
				$dir = $ds->getMountPoint();
				$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
				if (!($xmlConfig->exists($xpath))) {
					$uuid = OMVUtil::uuid();
					$object = array(
						"uuid" => $uuid,
						"fsname" => $pooluuid,
						"dir" => $dir,
						"type" => "zfs",
						"opts" => "rw,relatime,xattr,noacl",
						"freq" => "0",
						"passno" => "0",
						"hidden" => "1"
					);
					$xmlConfig->set("//system/fstab",array("mntent" => $object));
				}
			}
		}
		return null;
	}

	/**
	 * Get an array with all ZFS objects
	 *
	 * @return An array with all ZFS objects
	 */
	public static function getZFSFlatArray() {
		$prefix = "root/pool-";
		$objects = array();
		$cmd = "zfs list -H -t all -o name,type 2>&1";
		$expanded = true;
		OMVModuleZFSUtil::exec($cmd,$out,$res);
		foreach ($out as $line) {
			$parts = preg_split('/\t/',$line);
			$path = $parts[0];
			$type = $parts[1];
			$subdirs = preg_split('/\//',$path);
			$root = $subdirs[0];
			$tmp = array();

			switch ($type) {
			case "filesystem":
				if (strpos($path,'/') === false) {
					//This is a Pool
					$tmp = array('id'=>$prefix . $path,
						'parentid'=>'root',
						'name'=>$path,
						'type'=>'Pool',
						'icon'=>'images/raid.png',
						'expanded'=>$expanded,
						'path'=>$path);
					$pool = new OMVModuleZFSZpool($path);
					$tmp['size'] = $pool->getSize();
					$tmp['used'] = $pool->getAttribute("allocated");
					$tmp['available'] = $pool->getAttribute("free");
					$tmp['mountpoint'] = $pool->getMountPoint();
					array_push($objects,$tmp);
				} else {
					//This is a Filesystem
					preg_match('/(.*)\/(.*)$/', $path, $result);
					$tmp = array('id'=>$prefix . $path,
						'parentid'=>$prefix . $result[1],
						'name'=>$result[2],
						'icon'=>"images/filesystem.png",
						'path'=>$path,
						'expanded'=>$expanded);
					$ds =  new OMVModuleZFSDataset($path);
					if ($ds->isClone()) {
						//This is a cloned Filesystem
						$tmp['type'] = "Clone";
						$tmp['origin'] = $ds->getOrigin();
					} else {
						//This is a standard Filesystem.
						$tmp['type']= ucfirst($type);
					}
					$tmp['size'] = "n/a";
					$used = $ds->getProperty("used");
					$tmp['used'] = $used['value'];
					$available = $ds->getProperty("available");
					$tmp['available'] = $available['value'];
					$tmp['mountpoint'] = $ds->getMountPoint();
					array_push($objects,$tmp);
				}
				break;

			case "volume":
				preg_match('/(.*)\/(.*)$/', $path, $result);
				$tmp = array('id'=>$prefix . $path,
					'parentid'=>$prefix . $result[1],
					'name'=>$result[2],
					'type'=>ucfirst($type),
					'icon'=>"images/save.png",
					'path'=>$path,
					'expanded'=>$expanded);
				$vol = new OMVModuleZFSZvol();
				$tmp['size'] = $vol->getSize();
				$tmp['used'] = "n/a";
				$tmp['available'] = "n/a";
				$tmp['mountpoint'] = "n/a";
				array_push($objects,$tmp);
				break;

			case "snapshot":
				preg_match('/(.*)\@(.*)$/', $path, $result);
				$subdirs = preg_split('/\//',$result[1]);
				$root = $subdirs[0];
				$tmp = array('id'=>$prefix . $path,
					'parentid'=>$prefix . $result[1],
					'name'=>$result[2],
					'type'=>ucfirst($type),
					'icon'=>'images/zfs_snap.png',
					'path'=>$path,
					'expanded'=>$expanded);
				$tmp['size'] = "n/a";
				$tmp['used'] = "n/a";
				$tmp['available'] = "n/a";
				$tmp['mountpoint'] = "n/a";
				array_push($objects,$tmp);
				break;

			default:
				break;
			}
		}
		return $objects;
	}

	/**
	 * Create a tree structured array
	 *
	 * @param &$list The flat array to convert to a tree structure
	 * @param $parent Root node of the tree to create
	 * @return Tree structured array
	 *
	 */
	public static function createTree(&$list, $parent){
		$tree = array();
		foreach ($parent as $k=>$l){
			if(isset($list[$l['id']])){
				$l['leaf'] = false;
				$l['children'] = OMVModuleZFSUtil::createTree($list, $list[$l['id']]);
			} else {
				$l['leaf'] = true;
			}
			$tree[] = $l;
		}
		return $tree;
	}

	/**
	 * Get all Datasets as objects
	 * 
	 * @return An array with all the Datasets
	 */
	public static function getAllDatasets() {
		$datasets = array();
		$cmd = "zfs list -H -t filesystem -o name 2>&1";
		OMVModuleZFSUtil::exec($cmd, $out, $res);
		foreach ($out as $name) {
			$ds = new OMVModuleZFSDataset($name);
			array_push($datasets, $ds);
		}
		return $datasets;
	}

	/**
	 * Helper function to execute a command and throw an exception on error
	 * (requires stderr redirected to stdout for proper exception message).
	 * 
	 * @param string $cmd Command to execute
	 * @param array &$out If provided will contain output in an array
	 * @param int &$res If provided will contain Exit status of the command
	 * @return string Last line of output when executing the command
	 * @throws OMVModuleZFSException
	 * @access public
	 */
	public static function exec($cmd, &$out = null, &$res = null) {
		$tmp = OMVUtil::exec($cmd, $out, $res);
		if ($res) {
			throw new OMVModuleZFSException(implode("\n", $out));
		}
		return $tmp;
	}

}


?>
Commit	Line	Data
b633468b NB	1	<?php
	2	require_once("Exception.php");
	3	require_once("openmediavault/util.inc");
	4	require_once("Dataset.php");
54b9d43e	5	require_once("Zvol.php");
97e4887b NB	6	require_once("Vdev.php");
97e4887b NB	7	require_once("Zpool.php");
b633468b NB	8
	9	/**
	10	* Helper class for ZFS module
	11	*/
	12	class OMVModuleZFSUtil {
	13
cc1caa78 NB	14	/**
	15	* Manages relocation of ZFS filesystem mountpoints in the OMV backend.
	16	* Needed when the user changes mountpoint of a filesystem in the GUI.
	17	*
	18	*/
	19	public static function relocateFilesystem($name) {
	20	global $xmlConfig;
	21	$poolname = OMVModuleZFSUtil::getPoolname($name);
	22	$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
	23	$ds = new OMVModuleZFSDataset($name);
	24	$dir = $ds->getMountPoint();
	25	$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
	26	$object = $xmlConfig->get($xpath);
	27	$object['dir'] = $property['value'];
	28	$xmlConfig->replace($xpath, $object);
	29	return null;
	30	}
	31
97e4887b NB	32	/**
	33	* Clears all ZFS labels on specified devices.
	34	* Needed for blkid to display proper data.
	35	*
	36	*/
	37	public static function clearZFSLabel($disks) {
	38	foreach ($disks as $disk) {
	39	$cmd = "zpool labelclear /dev/" . $disk . "1";
	40	OMVModuleZFSUtil::exec($cmd,$out,$res);
	41	}
cc1caa78	42	return null;
97e4887b NB	43	}
	44
	45	/**
	46	* Return all disks in /dev/sdXX used by the pool
	47	*
	48	* @return array An array with all the disks
	49	*/
	50	public static function getDevDisksByPool($name) {
	51	$pool = new OMVModuleZFSZpool($name);
	52	$disks = array();
	53	$vdevs = $pool->getVdevs();
	54	foreach ($vdevs as $vdev) {
	55	$vdisks = $vdev->getDisks();
	56	foreach ($vdisks as $vdisk) {
	57	if (preg_match('/^[a-z0-9]+$/', $vdisk)) {
	58	$disks[] = $vdisk;
	59	continue;
	60	}
	61	$cmd = "ls -la /dev/disk/by-path/" . $vdisk;
	62	unset($out);
	63	OMVModuleZFSUtil::exec($cmd,$out,$res);
	64	if (count($out) === 1) {
	65	if (preg_match('/^.*\/([a-z0-9]+)$/', $out[0], $match)) {
	66	$disks[] = $match[1];
	67	}
	68	}
	69	}
	70	}
	71	return($disks);
	72	}
	73
216661f4 NB	74	/**
	75	* Deletes all shared folders pointing to the specifc path
	76	*
	77	*/
	78	public static function deleteShares($name) {
	79	global $xmlConfig;
216661f4 NB	80	$poolname = OMVModuleZFSUtil::getPoolname($name);
216661f4 NB	81	$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
cc1caa78 NB	82	$ds = new OMVModuleZFSDataset($name);
	83	$dir = $ds->getMountPoint();
	84	$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
216661f4 NB	85	$mountpoint = $xmlConfig->get($xpath);
216661f4 NB	86	$mntentuuid = $mountpoint['uuid'];
cc1caa78 NB	87	$xpath = "//system/shares/sharedfolder[mntentref='" . $mntentuuid . "']";
	88	$objects = $xmlConfig->getList($xpath);
	89	foreach ($objects as $object) {
	90	$tmpxpath = sprintf("//*[contains(name(),'sharedfolderref')]".
	91	"[contains(.,'%s')]", $object['uuid']);
	92	if ($xmlConfig->exists($tmpxpath)) {
	93	throw new OMVModuleZFSException("The Filesystem is shared and in use. Please delete all references and try again.");
	94	}
	95	}
216661f4 NB	96	$xmlConfig->delete($xpath);
216661f4 NB	97	$dispatcher = &OMVNotifyDispatcher::getInstance();
97e4887b	98	$dispatcher->notify(OMV_NOTIFY_DELETE,"org.openmediavault.system.shares.sharedfolder",$object);
216661f4 NB	99	}
	100
	101	/**
	102	* Get the relative path by complete path
	103	*
	104	* @return string Relative path of the complet path
	105	*/
	106	public static function getReldirpath($path) {
	107	$subdirs = preg_split('/\//',$path);
	108	$reldirpath = "";
	109	for ($i=2;$i<count($subdirs);$i++) {
	110	$reldirpath .= $subdirs[$i] . "/";
	111	}
	112	return(rtrim($reldirpath, "/"));
	113
	114	}
	115
e20fe312 NB	116	/**
	117	* Get /dev/disk/by-path from /dev/sdX
	118	*
	119	* @return string Disk identifier
	120	*/
	121	public static function getDiskPath($disk) {
	122	preg_match("/^.*\/([A-Za-z0-9]+)$/", $disk, $identifier);
	123	$cmd = "ls -la /dev/disk/by-path \| grep '$identifier[1]$'";
	124	OMVModuleZFSUtil::exec($cmd, $out, $res);
	125	if (is_array($out)) {
	126	$cols = preg_split('/[\s]+/', $out[0]);
	127	return($cols[count($cols)-3]);
	128	}
	129	}
	130
	131
4163f889 NB	132	/**
	133	* Get poolname from name of dataset/volume etc.
	134	*
	135	* @return string Name of the pool
	136	*/
	137	public static function getPoolname($name) {
	138	$tmp = preg_split('/[\/]+/', $name);
	139	return($tmp[0]);
	140	}
	141
13b8ca82 NB	142	/**
	143	* Get UUID of ZFS pool by name
	144	*
	145	* @return string UUID of the pool
	146	*/
4163f889 NB	147	public static function getUUIDbyName($poolname) {
4163f889 NB	148	$cmd = "zpool get guid " . $poolname . " 2>&1";
13b8ca82	149	OMVModuleZFSUtil::exec($cmd, $out, $res);
42856e8b NB	150	if (isset($out)) {
	151	$headers = preg_split('/[\s]+/', $out[0]);
	152	for ($i=0; $i<count($headers); $i++) {
	153	if (strcmp($headers[$i], "VALUE") === 0) {
	154	$valuecol=$i;
	155	break;
	156	}
13b8ca82	157	}
42856e8b NB	158	$line = preg_split('/[\s]+/', $out[1]);
42856e8b NB	159	return $line[$valuecol];
13b8ca82 NB	160	}
	161	return null;
	162	}
	163
a36352f7	164	/**
cc1caa78	165	* Add any missing ZFS filesystems to the OMV backend
a36352f7 NB	166	*
	167	*/
	168	public static function addMissingOMVMntEnt() {
	169	global $xmlConfig;
cc1caa78	170	$cmd = "zfs list -H -o name -t filesystem";
a36352f7 NB	171	OMVModuleZFSUtil::exec($cmd, $out, $res);
a36352f7 NB	172	foreach($out as $name) {
cc1caa78 NB	173	if (preg_match('/[\/]+/', $name)) {
	174	$poolname = OMVModuleZFSUtil::getPoolname($name);
	175	$pooluuid = OMVModuleZFSUtil::getUUIDbyName($poolname);
	176	$ds = new OMVModuleZFSDataset($name);
	177	$dir = $ds->getMountPoint();
	178	$xpath = "//system/fstab/mntent[fsname='" . $pooluuid . "' and dir='" . $dir . "' and type='zfs']";
	179	if (!($xmlConfig->exists($xpath))) {
	180	$uuid = OMVUtil::uuid();
	181	$object = array(
	182	"uuid" => $uuid,
	183	"fsname" => $pooluuid,
	184	"dir" => $dir,
	185	"type" => "zfs",
	186	"opts" => "rw,relatime,xattr,noacl",
	187	"freq" => "0",
1d1e2e95 NB	188	"passno" => "0",
1d1e2e95 NB	189	"hidden" => "1"
cc1caa78 NB	190	);
	191	$xmlConfig->set("//system/fstab",array("mntent" => $object));
	192	}
a36352f7 NB	193	}
	194	}
	195	return null;
	196	}
	197
b633468b NB	198	/**
	199	* Get an array with all ZFS objects
	200	*
	201	* @return An array with all ZFS objects
	202	*/
	203	public static function getZFSFlatArray() {
	204	$prefix = "root/pool-";
	205	$objects = array();
	206	$cmd = "zfs list -H -t all -o name,type 2>&1";
c4ed2435	207	$expanded = true;
b633468b NB	208	OMVModuleZFSUtil::exec($cmd,$out,$res);
	209	foreach ($out as $line) {
	210	$parts = preg_split('/\t/',$line);
c4ed2435 NB	211	$path = $parts[0];
	212	$type = $parts[1];
	213	$subdirs = preg_split('/\//',$path);
	214	$root = $subdirs[0];
	215	$tmp = array();
13b8ca82	216
c4ed2435 NB	217	switch ($type) {
	218	case "filesystem":
	219	if (strpos($path,'/') === false) {
5627dfd7	220	//This is a Pool
c4ed2435 NB	221	$tmp = array('id'=>$prefix . $path,
	222	'parentid'=>'root',
	223	'name'=>$path,
	224	'type'=>'Pool',
	225	'icon'=>'images/raid.png',
	226	'expanded'=>$expanded,
	227	'path'=>$path);
54b9d43e NB	228	$pool = new OMVModuleZFSZpool($path);
54b9d43e NB	229	$tmp['size'] = $pool->getSize();
f30d664a NB	230	$tmp['used'] = $pool->getAttribute("allocated");
f30d664a NB	231	$tmp['available'] = $pool->getAttribute("free");
54b9d43e	232	$tmp['mountpoint'] = $pool->getMountPoint();
c4ed2435	233	array_push($objects,$tmp);
c4ed2435	234	} else {
5627dfd7	235	//This is a Filesystem
c4ed2435	236	preg_match('/(.)\/(.)$/', $path, $result);
5627dfd7 NB	237	$tmp = array('id'=>$prefix . $path,
5627dfd7 NB	238	'parentid'=>$prefix . $result[1],
c4ed2435 NB	239	'name'=>$result[2],
	240	'icon'=>"images/filesystem.png",
	241	'path'=>$path,
	242	'expanded'=>$expanded);
	243	$ds = new OMVModuleZFSDataset($path);
1434b745 NB	244	if ($ds->isClone()) {
1434b745 NB	245	//This is a cloned Filesystem
c4ed2435 NB	246	$tmp['type'] = "Clone";
c4ed2435 NB	247	$tmp['origin'] = $ds->getOrigin();
1434b745 NB	248	} else {
1434b745 NB	249	//This is a standard Filesystem.
c4ed2435	250	$tmp['type']= ucfirst($type);
1434b745	251	}
54b9d43e NB	252	$tmp['size'] = "n/a";
	253	$used = $ds->getProperty("used");
	254	$tmp['used'] = $used['value'];
	255	$available = $ds->getProperty("available");
	256	$tmp['available'] = $available['value'];
	257	$tmp['mountpoint'] = $ds->getMountPoint();
1434b745	258	array_push($objects,$tmp);
b633468b	259	}
c4ed2435 NB	260	break;
	261
	262	case "volume":
	263	preg_match('/(.)\/(.)$/', $path, $result);
5627dfd7 NB	264	$tmp = array('id'=>$prefix . $path,
5627dfd7 NB	265	'parentid'=>$prefix . $result[1],
c4ed2435 NB	266	'name'=>$result[2],
c4ed2435 NB	267	'type'=>ucfirst($type),
18516c1e	268	'icon'=>"images/save.png",
c4ed2435 NB	269	'path'=>$path,
c4ed2435 NB	270	'expanded'=>$expanded);
54b9d43e NB	271	$vol = new OMVModuleZFSZvol();
	272	$tmp['size'] = $vol->getSize();
	273	$tmp['used'] = "n/a";
	274	$tmp['available'] = "n/a";
	275	$tmp['mountpoint'] = "n/a";
c4ed2435 NB	276	array_push($objects,$tmp);
	277	break;
	278
	279	case "snapshot":
	280	preg_match('/(.)\@(.)$/', $path, $result);
	281	$subdirs = preg_split('/\//',$result[1]);
	282	$root = $subdirs[0];
5627dfd7 NB	283	$tmp = array('id'=>$prefix . $path,
5627dfd7 NB	284	'parentid'=>$prefix . $result[1],
c4ed2435 NB	285	'name'=>$result[2],
	286	'type'=>ucfirst($type),
	287	'icon'=>'images/zfs_snap.png',
	288	'path'=>$path,
	289	'expanded'=>$expanded);
54b9d43e NB	290	$tmp['size'] = "n/a";
	291	$tmp['used'] = "n/a";
	292	$tmp['available'] = "n/a";
	293	$tmp['mountpoint'] = "n/a";
c4ed2435 NB	294	array_push($objects,$tmp);
	295	break;
	296
	297	default:
	298	break;
b633468b NB	299	}
	300	}
	301	return $objects;
	302	}
	303
	304	/**
	305	* Create a tree structured array
	306	*
	307	* @param &$list The flat array to convert to a tree structure
	308	* @param $parent Root node of the tree to create
	309	* @return Tree structured array
	310	*
	311	*/
	312	public static function createTree(&$list, $parent){
	313	$tree = array();
	314	foreach ($parent as $k=>$l){
	315	if(isset($list[$l['id']])){
	316	$l['leaf'] = false;
	317	$l['children'] = OMVModuleZFSUtil::createTree($list, $list[$l['id']]);
	318	} else {
	319	$l['leaf'] = true;
	320	}
	321	$tree[] = $l;
	322	}
	323	return $tree;
	324	}
	325
	326	/**
	327	* Get all Datasets as objects
	328	*
	329	* @return An array with all the Datasets
	330	*/
	331	public static function getAllDatasets() {
	332	$datasets = array();
	333	$cmd = "zfs list -H -t filesystem -o name 2>&1";
	334	OMVModuleZFSUtil::exec($cmd, $out, $res);
	335	foreach ($out as $name) {
	336	$ds = new OMVModuleZFSDataset($name);
	337	array_push($datasets, $ds);
	338	}
	339	return $datasets;
	340	}
	341
	342	/**
	343	* Helper function to execute a command and throw an exception on error
	344	* (requires stderr redirected to stdout for proper exception message).
	345	*
	346	* @param string $cmd Command to execute
	347	* @param array &$out If provided will contain output in an array
	348	* @param int &$res If provided will contain Exit status of the command
	349	* @return string Last line of output when executing the command
	350	* @throws OMVModuleZFSException
	351	* @access public
	352	*/
	353	public static function exec($cmd, &$out = null, &$res = null) {
	354	$tmp = OMVUtil::exec($cmd, $out, $res);
	355	if ($res) {
	356	throw new OMVModuleZFSException(implode("\n", $out));
	357	}
	358	return $tmp;
	359	}
	360
	361	}
	362
363
364	?>