src/Snapshot.php

   1 <?php
   2 require_once("Exception.php");
   3 require_once("openmediavault/util.inc");
   4
   5 /**
   6  * XXX detailed description
   7  *
   8  * @author    XXX
   9  * @version   XXX
  10  * @copyright XXX
  11  */
  12 class OMVModuleZFSSnapshot {
  13     // Attributes
  14     /**
  15      * Name of the Snapshot
  16      *
  17      * @var    string $name
  18      * @access private
  19      */
  20     private $name;
  21
  22     /**
  23      * Properties associated with the Snaphost
  24      *
  25      * @var    array $properties
  26      * @access private
  27      */
  28     private $properties;
  29
  30     // Associations
  31     // Operations
  32
  33         /**
  34          * Constructor. If the Snapshot already exists in the system the object will be updated with all
  35          * associated properties from commandline.
  36          *
  37          * @param string $name Name of the new Snapshot
  38          * @return void
  39          * @access public
  40          */
  41         public function __construct($name) {
  42                 $this->name = $name;
  43                 $qname = preg_quote($name, '/');
  44                 $cmd = "zfs list -H -t snapshot 2>&1";
  45                 $this->exec($cmd, $out, $res);
  46                 foreach ($out as $line) {
  47                         if (preg_match('/^' . $qname . '\t.*$/', $line)) {
  48                                 $this->updateAllProperties();
  49                                 continue;
  50                         }
  51                 }
  52         }
  53
  54         /**
  55          * Return name of the Snapshot
  56          *
  57          * @return string Nameof the Snapshot
  58          * @access public
  59          */
  60         public function getName() {
  61                 return $this->name;
  62         }
  63
  64         /**
  65          * Get a single property value associated with the Snapshot
  66          *
  67          * @param string $property Name of the property to fetch
  68          * @return array The returned array with the property. The property is an associative array with
  69          * two elements, <value> and <source>.
  70          * @access public
  71          */
  72         public function getProperty($property) {
  73                 return $this->properties["$property"];
  74         }
  75
  76         /**
  77          * Get an associative array of all properties associated with the Snapshot
  78          *
  79          * @return array $properties Each entry is an associative array with two elements
  80          * <value> and <source>
  81          * @access public
  82          */
  83         public function getProperties() {
  84                 return $this->properties;
  85         }
  86
  87         /**
  88          * Sets a number of Snapshot properties. If a property is already set it will be updated with the new value.
  89          *
  90          * @param  array $properties An associative array with properties to set
  91          * @return void
  92          * @access public
  93          */
  94         public function setProperties($properties) {
  95                 foreach ($properties as $newpropertyk => $newpropertyv) {
  96                         $cmd = "zfs set " . $newpropertyk . "=" . $newpropertyv . " " . $this->name . " 2>&1";
  97                         $this->exec($cmd,$out,$res);
  98                         $this->updateProperty($newpropertyk);
  99                 }
 100         }
 101
 102         /**
 103          * Get single Snapshot property from commandline and update object property attribute
 104          *
 105          * @param string $property Name of the property to update
 106          * @return void
 107          * @access private
 108          */
 109         private function updateProperty($property) {
 110                 $cmd = "zfs get -H " . $property . " " . $this->name . " 2>&1";
 111                 $this->exec($cmd,$out,$res);
 112                 $tmpary = preg_split('/\t+/', $out[0]);
 113                 $this->properties["$tmpary[1]"] = array("value" => $tmpary[2], "source" => $tmpary[3]);
 114         }
 115
 116         /**
 117          * Get all Snapshot properties from commandline and update object properties attribute
 118          *
 119          * @return void
 120          * @access private
 121          */
 122         private function updateAllProperties() {
 123                 $cmd = "zfs get -H all " . $this->name . " 2>&1";
 124                 $this->exec($cmd,$out,$res);
 125                 unset($this->properties);
 126                 foreach ($out as $line) {
 127                         $tmpary = preg_split('/\t+/', $line);
 128                         $this->properties["$tmpary[1]"] = array("value" => $tmpary[2], "source" => $tmpary[3]);
 129                 }
 130         }
 131
 132         /**
 133          * Craete a Snapshot on commandline. Optionally provide a number of properties to set.
 134          *
 135          * @param array $properties Properties to set when creating the dataset.
 136          * @return void
 137          * @access public
 138          */
 139         public function create(array $properties = null) {
 140                 $cmd = "zfs snapshot " . $this->name . " 2>&1";
 141                 $this->exec($cmd,$out,$res);
 142                 $this->updateAllProperties();
 143                 $this->setProperties($properties);
 144         }
 145
 146         /**
 147          * Helper function to execute a command and throw an exception on error
 148          * (requires stderr redirected to stdout for proper exception message).
 149          *
 150          * @param string $cmd Command to execute
 151          * @param array &$out If provided will contain output in an array
 152          * @param int &$res If provided will contain Exit status of the command
 153          * @return string Last line of output when executing the command
 154          * @throws OMVModuleZFSException
 155          * @access private
 156          */
 157         private function exec($cmd, &$out = null, &$res = null) {
 158                 $tmp = OMVUtil::exec($cmd, $out, $res);
 159                 if ($res) {
 160                         throw new OMVModuleZFSException(implode("\n", $out));
 161                 }
 162                 return $tmp;
 163         }
 164 }
 165
 166 ?>