Working With Tasks
------------------

Tasks are generated by the system whenever a build is submitted for a package.
A task is created for each build target associated with a package's releases.
Tasks are created by the system, and can not be created, updated, or deleted
by users.

Note: The below examples assume that you have set your 'current-project'
to 'my-project', so as to not have to pass the '--project' option with every
command.  This can be done as:

.. code-block:: text

    $ mf workon my-project
    
    
Listing Tasks
^^^^^^^^^^^^^

.. code-block:: text
    
    # list all open tasks for a project
    $ mf task listall
    
    # but filter results
    $ mf task listall -f php

    # including closed tasks
    $ mf task listall --all

*Note: it is more common to list builds via the quickview, which shows the 
associated tasks under each build.*


Showing Data For a Task
^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf task show php-5.2.14-1
    
              Label | php-5.2.14-1.el5.i386                                      
              Owner | john.doe                                                        
              Build | php-5.2.14-1                                             
            Package | php
             Target | el5.i386                                                      
            Project | my-project
         Created On | 2010-12-01 09:57:55                                             
        Last Update | 2010-12-01 10:17:03                                         
         Start Time | 2010-12-01 10:13:57                                             
           End Time | 2010-12-01 10:17:03                                         
             Status | BuildSuccess                                                     
           Data Dir | projects/rpmdev/builds/php-5.2.14-1/php-5.2.14-1.el5.i386 
        Building On | None                                                         
        End of Life | True                                                         

            configs | mf-target.cfg                                                   
                      site-defaults.cfg                                               
                      logging.ini                                                     
                  
               Logs | stdout                                                          
                      build.log                                                       
                      state.log                                                       
                      stderr                                                          
                      root.log                                                        
                  
            Sources | php-5.2.14-1.src.rpm                    

                  
              Files | php-5.2.14-1.el5.i386.rpm                   
                      php-common-5.2.14-1.el5
                      php-devel-5.2.14-1.el5
                      php-mysql-5.2.14-1.el5
                      ...


Viewing Task Logs and Config Files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf task taillogs php-5.2.14-1.el5.i386 build.log
    
    $ mf task showlog php-5.2.14-1.el5.i386 build.log
    
    $ mf task showconfig php-5.2.14-1.el5.i386 mf-target.cfg
    
*Note: The log and config file names are based on the build_handler for the
build and will differ with every project.  The 'taillogs' option tails the
last 25 lines of every log file by default.  This can be altered with the
'--num-lines=XX' option where XX is an integer.  The 'showlog' option outputs
the entire contents of a single log.  Finally, 'showconfig' is similar in that
it outputs the entire contents of a single config file.*


Downloading Files From a Task
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: text

    $ mf task getfiles php-5.2.14-1.el5.i386
    
    $ mf task getsource php-5.2.14-1.el5.i386


Resetting a Task
^^^^^^^^^^^^^^^^

It is possible to reset a task, which essentially halts and deletes any
progress and sets the task to 'New'.  This is useful in situations where the
task failed as a flook and not because the build is bad.

.. code-block:: text

    $ mf task reset php-5.2.14-1.el5.i386