Provided by: libnetapp-perl_500.002-3_all bug

NAME

       NetApp::Volume -- OO class for creating and managing NetApp filer volumes

SYNOPSIS

           use NetApp::Filer;
           use NetApp::Aggregate;

           my $filer = NetApp::Filer->new({ .... });

           my @volume_names    = $filer->get_volume_names;

           my @volumes         = $filer->get_volumes;

           my $volume          = $filer->get_volume( 'volname' );

DESCRIPTION

       This class encapsulates a single NetApp filer volume, and provides methods for querying
       information about the volume and it's sub-objects (eg. qtrees), as well as methods for
       managing the volume itself.

INSTANCE METHODS

   get_filer
       Returns the NetApp::Filer object representing the filer on which the aggregate exists.

   get_name
       Returns the name of the volume as a string.

   get_states, get_statuses, get_options
       Each of these methods returns a list of strings, each of which represents a single state,
       status, or option for the volume.

           NOTE: All you English grammar pluralization rules fanatics can
           give up trying to convince the author to call that one method
           get_stati.

   get_state( $state ), get_status( $status ), get_option( $option )
       Each of these methods returns the value for the specified state, status or option.  If
       that particular key wasn't present, then this method will return undef.  This makes it
       easy to tell the difference between a key that doesn't exist, and one that has a false
       value.

   set_option( $option => $value )
       This method sets a single option to the specified value.  It always returns true, and
       raises a fatal exception if it can not set the option.

   get_aggregate_name
       Returns the name of the aggregate on which the volume lives.  For a "traditonal" volume,
       this will be a false value.

   get_aggregate
       Returns the NetApp::Aggregate object representing the aggregate on which the volume lives.
       For a "traditonal" volume, this will be a false value.

   get_qtree_names
       Returns a list of strings, each of which is the name of a qtree on the volume.

   get_qtrees
       Returns a list of NetApp::Qtree objects, each of which represents a single qtree on the
       volume.

   get_qtree( $name )
       Returns a single NetApp::Qtree object for the specified qtree name. The name must in the
       form of a pathname, for example:

           /vol/volume_name/qtree_name

       The qtree_name is optional if querying the object for a volume's qtree.  This method
       simply returns nothing if the specified qtree doesn't exist on the volume.

   get_language
       Returns a string representing the language code for the volume.

   set_language( $language )
       Set the language code to the specified value.  Always returns a true value, or raises a
       fatal exception if the language code can not be set.

   get_size
       Returns the size of the volume as a string.

   set_size( $size )
       This method sets the size of the volume to the specified value.  In all cases, the $size
       value is of the same form accepted by the create() method, and the underlying ONTAP CLI
       command:

           [+|-] <number> k|m|g|t

   get_maxfiles
       Returns the maxfiles value for the volume.

   set_maxfiles( $maxfiles )
       Sets the maxfiles value for the volume.

   is_clone
       Returns true if the volume is a clone, false otherwise.

   get_parent_name
       Returns a string representing the name of the parent volume, if this volume is a clone.

   get_parent
       Returns a NetApp::Volume object representing the parent volume, if this volume is a clone.

   get_snapshot_name
       Returns a string representing the snapshot name, if the volume is a clone.

   get_snapshot
       NOT YET IMPLEMENTED.  This will return a NetApp::Snapshot object, once the API is extended
       to support snapshots (RSN, I'm sure...)

   get_snapmirrors
       Returns a list of NetApp::Snapmirror objects, each of which represents a snapmirror
       relationship for this volume.

   offline( %args )
       Takes the volume offline.  The arguments are as follows:

           $volume->offline(
               # Optional arguments
               cifsdelaytime   => $cifsdelaytime,
           );

   online( %args )
       Bring the volume online.  The arguments are as follows:

           $volume->online(
               # Optional arguments
               force   => 1,
           );

   rename( %args )
       Renames the volume to the specified newname.  Always returns a true value, and raises a
       fatal exception if the name can not be changed.  The arguments are as follows:

           $volume->rename(
               # Required arguments
               newname         => $newname,
           );

   restrict( %args )
       Puts the volume into the restricted state.  The arguments are as follows:

           $volume->restrict(
               # Optional arguments
               cifsdelaytime   => $cifsdelaytime,
           );

   Snapshot Specific Methods
       get_snapshots

       Returns a list of NetApp::Snapshot objects for each of the snapshots of the volume.

       get_snapshot( $name )

       Returns a single NetApp::Snapshot object matching the specified name, if it exists for the
       volume.

       create_snapshot( $name )

       Creates a snapshot of the volume with the specified name.

       delete_snapshot( $name )

       Deletes a snapshot of the volume with the specified name.

       get_snapshot_deltas

       Returns a list of NetApp::Snapshot::Delta objects for each snapshot delta for the volume.

       get_snapshot_reserved

       Returns a string representing the amount of reserved space, as a percentage.  This string
       does NOT include the % sign.

       set_snapshot_reserved( $percentage )

       Sets the snapshot reserved space to the specified percentage, which should also NOT
       include the % sign.

       get_snapshot_schedule

       Returns a NetApp::Snapshot::Schedule object representing the snapshot schedule for the
       volume.

       set_snapshot_schedule( %args )

       Sets the snapshot schedule for the volume based on the arguments passed.  The argument
       syntax is:

           $volume->set_snapshot_schedule(
               weekly          => $weekly,
               daily           => $daily,
               hourly          => $hourly,
               hourlist        => [
                   $hour1, $hour2, $hour3, ....
               ],
           );

       enable_shapshot_autodelete

       This method turns on snapshot autodelete for the volume.

       disable_snapshot_autodelete

       This method turns off snapshot autodelete for the volume.

       reset_snapshot_autodelete

       This method resets snapshot autodelete for the volume to the filer defaults.

       set_snapshot_autodelete_option( $name => $value )

       Sets the specified snapshot autodelete option ($name) to the specified $value.

       get_snapshot_autodelete_option( $name )

       Returns the value of the specified autodelete option ($name).  Note that if the prefix is
       "(not specified)", then the value returned is the empty string.

UNIMPLEMENTED COMMANDS

       The following ONTAP vol commands are not implemented, because the same functionality and
       information is provided through this API via some other means.

   container
       The aggregate containing the volume can be obtained using:

           $volume->get_aggregate;

       which will return the NetApp::Aggregate object for it.

TO BE IMPLEMENTED

       All other commands will be implemented in a future release of this API.  Commands for
       flexible volumes will most likely have preference over traditional volumes.

   autosize
       It's not yet clear just how this one should be implemented, since the command does several
       things.  It enables and disables the autosize feature, or resets it to defaults, and it
       also sets the maximum and incremental sizes to autosize to.

       This could be implemented a few different ways, for example:

           $volume->autosize(
               # Optional arguments
               maximum         => $maximum,
               incremental     => $incremental,
               # Optional, but mutually exclusive:
               on              => 1,
               off             => 1,
               reset           => 1,
           );

       That seems a little clumsy, though.  Perhaps a better interface would be to have methods
       to control the state of the feature:

           $volume->enable_autosize;
           $volume->disable_autosize;
           $volume->reset_autosize;

       and then methods to set/get the autosize values:

           $volume_set_autosize(
               # Required but mutually exclusive options
               maximum         => $maximum,
               incremental     => $incremental,
           );

           $volume->get_autosize;