Working With Distros
--------------------

The 'distros' resource defines distroitectures that the workers support. A
distro is the base for creating releases, and build targets.  It is a simple
identifier for the Vendor of the distribution (i.e. redhat, fedora, ubuntu)

Distros are system wide, and configured by the system administrator.

Creating an Distro
^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf distro create -l redhat --display-name "RedHat"
    

Updating an Distro
^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf distro update redhat --display-name "RedHat Enterprise Linux"
    

Deleting an Distro
^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf distro delete redhat
    

Listing Distros
^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf distro listall
    fedora
    redhat
    solaris
    ubuntu
    
    $ mf distro listall -f linux
    fedora
    redhat
    ubuntu

*Note: The listall -f/--filter option matches on common members of the 
resource such as label, and in this case display name.*


Showing Data For an Distro
^^^^^^^^^^^^^^^^^^^^^^^^^^
 
.. code-block:: text

    $ mf distro show redhat
    
              Label | redhat                                                          
       Display Name | RedHat Enterprise Linux                                         
         Created By | mf-admin                                                        
         Created On | 2010-11-30 20:09:16                                             
        Last Update | 2010-11-30 20:09:16                                             

           Releases | el5
                      el6