mdata-list man page on SmartOS

Printed from

MDATA-LIST(1m)		       Metadata Commands		MDATA-LIST(1m)

       mdata-list -- Fetch the list of available metadata key-value pairs.


       The mdata-list command allows the user (or a script) to query the meta‐
       data 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 a
       key-value pair may be obtained by passing its  name  to	the  mdata-get

       The  list  of  all  customer-provided  metadata key-value pairs 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 avail‐
       able.  Non-transient failures 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.

       The following exit values are returned:

	    Successful completion.

	    The list of key-value pairs was emitted to stdout.

	    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  misconfigu‐
	    ration exists.

	    A usage error occurred.

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

       mdata-delete(1m), mdata-get(1m), mdata-put(1m)

Joyent SmartDataCenter		 October 2013			MDATA-LIST(1m)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net