GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
MDATA-LIST(1) Metadata Commands MDATA-LIST(1)

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

/usr/sbin/mdata-list

The mdata-list 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 a key-value pair may be obtained by passing its name to the mdata-get command.

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 available. 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:

0

Successful completion.

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

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.

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

October 2013 Joyent SmartDataCenter

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.