iPXE
imgmgmt.c
Go to the documentation of this file.
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., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 #include <stdint.h>
27 #include <stdlib.h>
28 #include <stdio.h>
29 #include <errno.h>
30 #include <ipxe/image.h>
31 #include <ipxe/downloader.h>
32 #include <ipxe/monojob.h>
33 #include <ipxe/open.h>
34 #include <ipxe/uri.h>
35 #include <usr/imgmgmt.h>
36 
37 /** @file
38  *
39  * Image management
40  *
41  */
42 
43 /**
44  * Download a new image
45  *
46  * @v uri URI
47  * @v timeout Download timeout
48  * @v image Image to fill in
49  * @ret rc Return status code
50  */
51 int imgdownload ( struct uri *uri, unsigned long timeout,
52  struct image **image ) {
53  struct uri uri_redacted;
54  char *uri_string_redacted;
55  int rc;
56 
57  /* Construct redacted URI */
58  memcpy ( &uri_redacted, uri, sizeof ( uri_redacted ) );
59  uri_redacted.user = NULL;
60  uri_redacted.password = NULL;
61  uri_redacted.equery = NULL;
62  uri_redacted.efragment = NULL;
63  uri_string_redacted = format_uri_alloc ( &uri_redacted );
64  if ( ! uri_string_redacted ) {
65  rc = -ENOMEM;
66  goto err_uri_string;
67  }
68 
69  /* Resolve URI */
70  uri = resolve_uri ( cwuri, uri );
71  if ( ! uri ) {
72  rc = -ENOMEM;
73  goto err_resolve_uri;
74  }
75 
76  /* Allocate image */
77  *image = alloc_image ( uri );
78  if ( ! *image ) {
79  rc = -ENOMEM;
80  goto err_alloc_image;
81  }
82 
83  /* Create downloader */
84  if ( ( rc = create_downloader ( &monojob, *image ) ) != 0 ) {
85  printf ( "Could not start download: %s\n", strerror ( rc ) );
86  goto err_create_downloader;
87  }
88 
89  /* Wait for download to complete */
90  if ( ( rc = monojob_wait ( uri_string_redacted, timeout ) ) != 0 )
91  goto err_monojob_wait;
92 
93  /* Register image */
94  if ( ( rc = register_image ( *image ) ) != 0 ) {
95  printf ( "Could not register image: %s\n", strerror ( rc ) );
96  goto err_register_image;
97  }
98 
99  err_register_image:
100  err_monojob_wait:
101  err_create_downloader:
102  image_put ( *image );
103  err_alloc_image:
104  uri_put ( uri );
105  err_resolve_uri:
106  free ( uri_string_redacted );
107  err_uri_string:
108  return rc;
109 }
110 
111 /**
112  * Download a new image
113  *
114  * @v uri_string URI string
115  * @v timeout Download timeout
116  * @v image Image to fill in
117  * @ret rc Return status code
118  */
119 int imgdownload_string ( const char *uri_string, unsigned long timeout,
120  struct image **image ) {
121  struct uri *uri;
122  int rc;
123 
124  if ( ! ( uri = parse_uri ( uri_string ) ) )
125  return -ENOMEM;
126 
127  rc = imgdownload ( uri, timeout, image );
128 
129  uri_put ( uri );
130  return rc;
131 }
132 
133 /**
134  * Acquire an image
135  *
136  * @v name_uri Name or URI string
137  * @v timeout Download timeout
138  * @v image Image to fill in
139  * @ret rc Return status code
140  */
141 int imgacquire ( const char *name_uri, unsigned long timeout,
142  struct image **image ) {
143 
144  /* If we already have an image with the specified name, use it */
145  *image = find_image ( name_uri );
146  if ( *image )
147  return 0;
148 
149  /* Otherwise, download a new image */
150  return imgdownload_string ( name_uri, timeout, image );
151 }
152 
153 /**
154  * Display status of an image
155  *
156  * @v image Executable/loadable image
157  */
158 void imgstat ( struct image *image ) {
159  struct image_tag *tag;
160 
161  printf ( "%s : %zd bytes", image->name, image->len );
162  if ( image->type )
163  printf ( " [%s]", image->type->name );
165  if ( tag->image == image )
166  printf ( " [%s]", tag->name );
167  }
168  if ( image->flags & IMAGE_TRUSTED )
169  printf ( " [TRUSTED]" );
171  printf ( " [AUTOFREE]" );
172  if ( image->flags & IMAGE_HIDDEN )
173  printf ( " [HIDDEN]" );
174  if ( image->cmdline )
175  printf ( " \"%s\"", image->cmdline );
176  printf ( "\n" );
177 }
178 
179 /**
180  * Create image from block of memory
181  *
182  * @v name Name
183  * @v data Image data
184  * @v len Length
185  * @ret rc Return status code
186  */
187 int imgmem ( const char *name, userptr_t data, size_t len ) {
188  struct image *image;
189 
190  /* Create image */
191  image = image_memory ( name, data, len );
192  if ( ! image ) {
193  printf ( "Could not create image\n" );
194  return -ENOMEM;
195  }
196 
197  return 0;
198 }
unsigned int flags
Flags.
Definition: image.h:36
const char * equery
Query (with original URI encoding)
Definition: uri.h:84
int imgmem(const char *name, userptr_t data, size_t len)
Create image from block of memory.
Definition: imgmgmt.c:187
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
const char * name
Definition: ath9k_hw.c:1984
int printf(const char *fmt,...)
Write a formatted string to the console.
Definition: vsprintf.c:464
static void uri_put(struct uri *uri)
Decrement URI reference count.
Definition: uri.h:205
An image tag.
Definition: image.h:154
int monojob_wait(const char *string, unsigned long timeout)
Wait for single foreground job to complete.
Definition: monojob.c:81
struct image * find_image(const char *name)
Find image by name.
Definition: image.c:340
Error codes.
struct image_type * type
Image type, if known.
Definition: image.h:46
struct image * image_memory(const char *name, userptr_t data, size_t len)
Create registered image from block of memory.
Definition: image.c:569
Image downloader.
An executable image.
Definition: image.h:24
Uniform Resource Identifiers.
#define IMAGE_AUTO_UNREGISTER
Image will be automatically unregistered after execution.
Definition: image.h:70
char * name
Name of this image type.
Definition: image.h:78
char * cmdline
Command line to pass to image.
Definition: image.h:39
Single foreground job.
#define ENOMEM
Not enough space.
Definition: errno.h:534
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
void * memcpy(void *dest, const void *src, size_t len) __nonnull
uint32_t userptr_t
A pointer to a user buffer.
Definition: libkir.h:159
Executable images.
void imgstat(struct image *image)
Display status of an image.
Definition: imgmgmt.c:158
#define IMAGE_TAGS
Image tag table.
Definition: image.h:162
struct interface monojob
Definition: monojob.c:56
char * format_uri_alloc(const struct uri *uri)
Format URI.
Definition: uri.c:540
int create_downloader(struct interface *job, struct image *image)
Instantiate a downloader.
Definition: downloader.c:258
int register_image(struct image *image)
Register executable image.
Definition: image.c:286
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
static void(* free)(struct refcnt *refcnt))
Definition: refcnt.h:54
size_t len
Length of raw file image.
Definition: image.h:43
#define IMAGE_HIDDEN
Image will be hidden from enumeration.
Definition: image.h:73
#define IMAGE_TRUSTED
Image is trusted.
Definition: image.h:67
#define for_each_table_entry(pointer, table)
Iterate through all entries within a linker table.
Definition: tables.h:385
static void image_put(struct image *image)
Decrement reference count on an image.
Definition: image.h:229
Data transfer interface opening.
const char * efragment
Fragment (with original URI encoding)
Definition: uri.h:86
Image management.
int imgdownload_string(const char *uri_string, unsigned long timeout, struct image **image)
Download a new image.
Definition: imgmgmt.c:119
uint8_t data[48]
Additional event data.
Definition: ena.h:22
const char * password
Password.
Definition: uri.h:74
const char * user
User name.
Definition: uri.h:72
A Uniform Resource Identifier.
Definition: uri.h:64
int imgdownload(struct uri *uri, unsigned long timeout, struct image **image)
Download a new image.
Definition: imgmgmt.c:51
void timeout(int)
struct uri * resolve_uri(const struct uri *base_uri, struct uri *relative_uri)
Resolve base+relative URI.
Definition: uri.c:694
struct uri * cwuri
Current working URI.
Definition: cwuri.c:38
struct image * alloc_image(struct uri *uri)
Allocate executable image.
Definition: image.c:103
uint64_t tag
Identity tag.
Definition: edd.h:30
char * name
Name.
Definition: image.h:34
uint32_t len
Length.
Definition: ena.h:14
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
int imgacquire(const char *name_uri, unsigned long timeout, struct image **image)
Acquire an image.
Definition: imgmgmt.c:141
struct uri * parse_uri(const char *uri_string)
Parse URI.
Definition: uri.c:296