src/usr/imgmgmt.c

   1 /*
   2  * Copyright (C) 2007 Michael Brown <mbrown@fensystems.co.uk>.
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License as
   6  * published by the Free Software Foundation; either version 2 of the
   7  * License, or any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17  */
  18
  19 #include <stdint.h>
  20 #include <stdlib.h>
  21 #include <stdio.h>
  22 #include <errno.h>
  23 #include <gpxe/image.h>
  24 #include <gpxe/downloader.h>
  25 #include <gpxe/monojob.h>
  26 #include <gpxe/open.h>
  27 #include <usr/imgmgmt.h>
  28
  29 /** @file
  30  *
  31  * Image management
  32  *
  33  */
  34
  35 static int imgfetch_autoload ( struct image *image ) {
  36         int rc;
  37
  38         if ( ( rc = register_image ( image ) ) != 0 )
  39                 return rc;
  40
  41         if ( ( rc = image_autoload ( image ) ) != 0 )
  42                 return rc;
  43
  44         return 0;
  45 }
  46
  47 /**
  48  * Fetch an image
  49  *
  50  * @v uri_string        URI as a string (e.g. "http://www.nowhere.com/vmlinuz")
  51  * @v name              Name for image, or NULL
  52  * @ret new_image       Newly created image
  53  * @ret rc              Return status code
  54  */
  55 int imgfetch ( struct image *image, const char *uri_string, int load ) {
  56         int rc;
  57
  58         if ( ( rc = create_downloader ( &monojob, image,
  59                                         ( load ? imgfetch_autoload :
  60                                           register_image ),
  61                                         LOCATION_URI_STRING,
  62                                         uri_string ) ) == 0 )
  63                 rc = monojob_wait();
  64
  65         return rc;
  66 }
  67
  68 /**
  69  * Load an image
  70  *
  71  * @v image             Image
  72  * @ret rc              Return status code
  73  */
  74 int imgload ( struct image *image ) {
  75         int rc;
  76
  77         /* Try to load image */
  78         if ( ( rc = image_autoload ( image ) ) != 0 )
  79                 return rc;
  80
  81         return 0;
  82 }
  83
  84 /**
  85  * Execute an image
  86  *
  87  * @v image             Image
  88  * @ret rc              Return status code
  89  */
  90 int imgexec ( struct image *image ) {
  91         return image_exec ( image );
  92 }
  93
  94 /**
  95  * Identify the first loaded image
  96  *
  97  * @ret image           Image, or NULL
  98  */
  99 struct image * imgautoselect ( void ) {
 100         struct image *image;
 101
 102         for_each_image ( image ) {
 103                 if ( image->flags & IMAGE_LOADED )
 104                         return image;
 105         }
 106
 107         return NULL;
 108 }
 109
 110 /**
 111  * Display status of an image
 112  *
 113  * @v image             Executable/loadable image
 114  */
 115 void imgstat ( struct image *image ) {
 116         printf ( "%s: %zd bytes", image->name, image->len );
 117         if ( image->type )
 118                 printf ( " [%s]", image->type->name );
 119         if ( image->flags & IMAGE_LOADED )
 120                 printf ( " [LOADED]" );
 121         if ( image->cmdline[0] )
 122                 printf ( " \"%s\"", image->cmdline );
 123         printf ( "\n" );
 124 }
 125
 126 /**
 127  * Free an image
 128  *
 129  * @v image             Executable/loadable image
 130  */
 131 void imgfree ( struct image *image ) {
 132         unregister_image ( image );
 133 }