HP StoreOnce Backup System CLI Reference Guide

nas modify share
Description of Command Function
Allows you to modify existing NAS shares.
Command Syntax
nas modify share [SETX] SHAREX [desc <description>] [readonly {yes|no}]
[secureerase {yes|no}] \ [version {1|2}]
Command Authority
Administrator
Command Object Requirements
• SET X – This required object is a service set where the NAS share is to be modified. X is the
numeric index of the service set. This object is required for a multi-node system and optional
for a single-node system. If it is omitted for a single-node system, it defaults to SET1. If the
object is specified (either for a multi-node or single-node system), it must be specified in the
exact position as given by the command syntax (i.e., it must immediately follow the share
command).
• SHARE X – This optional object defines a share index. X is the numeric index of the library.
This object must be specified in the exact position as given by the command syntax (i.e., it
must immediately follow the share command if SETX object is omitted; otherwise, it must
immediately follow the SETX object).
Command Parameter Requirements
• desc – This optional parameter specifies the NAS share description.
• readonly – This optional parameter specifies a read-only flag for a NAS share.
• secureerase – This optional parameter enables the secure erase function for a selected set or
share.
Requirements for Command Execution
• The command entry must conform to command syntax.
• The service set SETX object must be valid.
• The share SHAREX object must be valid.
Successful Command Output
Upon successful completion of the command, the following message is displayed, and then the
CLI returns to the user prompt:
Command Successful
Command Operation during Abnormal Conditions
If command execution fails, the following message is displayed:
Command failed.
Example
Example with desc and readonly parameters:
nas modify share SET1 SHARE0 desc CIFS share 0 readonly yes secureerase yes
Command Successful
Example showing version:
nas modify share SET1 SHARE0 desc "CIFS share 0
readonly yes
nas modify share SET1 SHARE0 version 2
104 Alphabetical List of Commands and Details