NAME

       mdata-get -- Fetch the value of a metadata key-value pair.

SYNOPSIS

       /usr/sbin/mdata-get keyname

DESCRIPTION

       The  mdata-get  command  allows  the  user (or a script) to query the metadata for a guest
       instance running in a SmartDataCenter (SDC) cloud.   Metadata  values  are  generally  set
       programmatically  via CloudAPI, or during interactive provisioning via a Web Portal.  They
       may also be set from within the instance with the mdata-put command.

       The value of the requested keyname will be printed to stdout.  If the metadata service  is
       unavailable  at  the time of the request, this command will block waiting for it to become
       available.  Non-transient failures, such as the non-existence of  the  requested  keyname,
       will  cause  the  program  to exit with a non-zero status.  Depending on the nature of the
       error, some diagnostic output may be printed to stderr.

EXIT STATUS

       The following exit values are returned:

       0
            Successful completion.

            The requested keyname was available, and its value was emitted to stdout.

       1
            Metadata value not found.

            The requested keyname was not found in the metadata.

       2
            An error occurred.

            An unexpected error condition occurred, which  is  believed  to  be  a  non-transient
            condition.   Retrying  the  request  is  not expected to resolve the error condition;
            either a software bug or misconfiguration exists.

       3
            A usage error occurred.

            Malformed arguments were passed to the program.   Check  the  usage  instructions  to
            ensure valid arguments are supplied.

SEE ALSO

       mdata-delete(1), mdata-list(1), mdata-put(1)