]>
git.datanom.net - omvzfs.git/blob - src/Zvol.php
2 require_once("Exception.php");
3 require_once("openmediavault/util.inc");
6 * XXX detailed description
12 class OMVModuleZFSZvol
{
32 * Array with properties assigned to the Zvol
34 * @var array $properties
43 * Constructor. If the Zvol already exists in the system the object will be updated with all
44 * associated properties from commandline.
46 * @param string $name Name of the new Zvol
50 public function __construct($name) {
52 $qname = preg_quote($name, '/');
53 $cmd = "zfs list -H -t volume";
54 $this->exec($cmd, $out, $res);
55 foreach ($out as $line) {
56 if (preg_match('/^' . $qname . '\t.*$/', $line)) {
57 $this->updateAllProperties();
58 $this->size
= $this->properties
["volsize"]["value"];
65 * Return name of the Zvol
67 * @return string $name
70 public function getName() {
75 * Get a single property value associated with the Zvol
77 * @param string $property Name of the property to fetch
78 * @return array The returned array with the property. The property is an associative array with
79 * two elements, <value> and <source>.
82 public function getProperty($property) {
83 return $this->properties
["$property"];
87 * Get an associative array of all properties associated with the Zvol
89 * @return array $properties Each entry is an associative array with two elements
90 * <value> and <source>
93 public function getProperties() {
94 return $this->properties
;
103 public function getSize() {
104 trigger_error('Not Implemented!', E_USER_WARNING
);
110 * @param $list<Feature> XXX
114 public function setProperties($properties) {
115 trigger_error('Not Implemented!', E_USER_WARNING
);
119 * Get all Zvol properties from commandline and update object properties attribute
124 private function updateAllProperties() {
125 $cmd = "zfs get -H all " . $this->name
;
126 $this->exec($cmd,$out,$res);
127 unset($this->properties
);
128 foreach ($out as $line) {
129 $tmpary = preg_split('/\t+/', $line);
130 $this->properties
["$tmpary[1]"] = array("value" => $tmpary[2], "source" => $tmpary[3]);
135 * Create a Zvol on commandline. Optionally provide a number of properties to set.
137 * @param string $size Size of the Zvol that should be created
138 * @param array $properties Properties to set when creating the dataset.
142 public function create($size, array $properties = null, bool $sparse = null) {
143 $cmd = "zfs create -p ";
144 if (isset($sparse) && $sparse == true) {
147 $cmd .= "-V " . $size . " " . $this->name
. " 2>&1";
148 $this->exec($cmd,$out,$res);
149 $this->updateAllProperties();
150 $this->setProperties($properties);
151 $this->size
= $this->properties
["volsize"]["value"];
155 * Helper function to execute a command and throw an exception on error
156 * (requires stderr redirected to stdout for proper exception message).
158 * @param string $cmd Command to execute
159 * @param array &$out If provided will contain output in an array
160 * @param int &$res If provided will contain Exit status of the command
161 * @return string Last line of output when executing the command
162 * @throws OMVModuleZFSException
165 private function exec($cmd, &$out = null, &$res = null) {
166 $tmp = OMVUtil
::exec($cmd, $out, $res);
168 throw new OMVModuleZFSException(implode("\n", $out));
This page took 0.071557 seconds and 6 git commands to generate.