mtd: Fix function description in part_validate comment
[platform/kernel/u-boot.git] / common / cmd_source.c
1 /*
2  * (C) Copyright 2001
3  * Kyle Harris, kharris@nexus-tech.net
4  *
5  * SPDX-License-Identifier:     GPL-2.0+
6  */
7
8 /*
9  * The "source" command allows to define "script images", i. e. files
10  * that contain command sequences that can be executed by the command
11  * interpreter. It returns the exit status of the last command
12  * executed from the script. This is very similar to running a shell
13  * script in a UNIX shell, hence the name for the command.
14  */
15
16 /* #define DEBUG */
17
18 #include <common.h>
19 #include <command.h>
20 #include <image.h>
21 #include <malloc.h>
22 #include <asm/byteorder.h>
23 #include <asm/io.h>
24 #if defined(CONFIG_8xx)
25 #include <mpc8xx.h>
26 #endif
27
28 int
29 source (ulong addr, const char *fit_uname)
30 {
31         ulong           len;
32         const image_header_t *hdr;
33         ulong           *data;
34         int             verify;
35         void *buf;
36 #if defined(CONFIG_FIT)
37         const void*     fit_hdr;
38         int             noffset;
39         const void      *fit_data;
40         size_t          fit_len;
41 #endif
42
43         verify = getenv_yesno ("verify");
44
45         buf = map_sysmem(addr, 0);
46         switch (genimg_get_format(buf)) {
47         case IMAGE_FORMAT_LEGACY:
48                 hdr = buf;
49
50                 if (!image_check_magic (hdr)) {
51                         puts ("Bad magic number\n");
52                         return 1;
53                 }
54
55                 if (!image_check_hcrc (hdr)) {
56                         puts ("Bad header crc\n");
57                         return 1;
58                 }
59
60                 if (verify) {
61                         if (!image_check_dcrc (hdr)) {
62                                 puts ("Bad data crc\n");
63                                 return 1;
64                         }
65                 }
66
67                 if (!image_check_type (hdr, IH_TYPE_SCRIPT)) {
68                         puts ("Bad image type\n");
69                         return 1;
70                 }
71
72                 /* get length of script */
73                 data = (ulong *)image_get_data (hdr);
74
75                 if ((len = uimage_to_cpu (*data)) == 0) {
76                         puts ("Empty Script\n");
77                         return 1;
78                 }
79
80                 /*
81                  * scripts are just multi-image files with one component, seek
82                  * past the zero-terminated sequence of image lengths to get
83                  * to the actual image data
84                  */
85                 while (*data++);
86                 break;
87 #if defined(CONFIG_FIT)
88         case IMAGE_FORMAT_FIT:
89                 if (fit_uname == NULL) {
90                         puts ("No FIT subimage unit name\n");
91                         return 1;
92                 }
93
94                 fit_hdr = buf;
95                 if (!fit_check_format (fit_hdr)) {
96                         puts ("Bad FIT image format\n");
97                         return 1;
98                 }
99
100                 /* get script component image node offset */
101                 noffset = fit_image_get_node (fit_hdr, fit_uname);
102                 if (noffset < 0) {
103                         printf ("Can't find '%s' FIT subimage\n", fit_uname);
104                         return 1;
105                 }
106
107                 if (!fit_image_check_type (fit_hdr, noffset, IH_TYPE_SCRIPT)) {
108                         puts ("Not a image image\n");
109                         return 1;
110                 }
111
112                 /* verify integrity */
113                 if (verify) {
114                         if (!fit_image_verify(fit_hdr, noffset)) {
115                                 puts ("Bad Data Hash\n");
116                                 return 1;
117                         }
118                 }
119
120                 /* get script subimage data address and length */
121                 if (fit_image_get_data (fit_hdr, noffset, &fit_data, &fit_len)) {
122                         puts ("Could not find script subimage data\n");
123                         return 1;
124                 }
125
126                 data = (ulong *)fit_data;
127                 len = (ulong)fit_len;
128                 break;
129 #endif
130         default:
131                 puts ("Wrong image format for \"source\" command\n");
132                 return 1;
133         }
134
135         debug ("** Script length: %ld\n", len);
136         return run_command_list((char *)data, len, 0);
137 }
138
139 /**************************************************/
140 #if defined(CONFIG_CMD_SOURCE)
141 int
142 do_source (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
143 {
144         ulong addr;
145         int rcode;
146         const char *fit_uname = NULL;
147
148         /* Find script image */
149         if (argc < 2) {
150                 addr = CONFIG_SYS_LOAD_ADDR;
151                 debug ("*  source: default load address = 0x%08lx\n", addr);
152 #if defined(CONFIG_FIT)
153         } else if (fit_parse_subimage (argv[1], load_addr, &addr, &fit_uname)) {
154                 debug ("*  source: subimage '%s' from FIT image at 0x%08lx\n",
155                                 fit_uname, addr);
156 #endif
157         } else {
158                 addr = simple_strtoul(argv[1], NULL, 16);
159                 debug ("*  source: cmdline image address = 0x%08lx\n", addr);
160         }
161
162         printf ("## Executing script at %08lx\n", addr);
163         rcode = source (addr, fit_uname);
164         return rcode;
165 }
166
167 #ifdef CONFIG_SYS_LONGHELP
168 static char source_help_text[] =
169         "[addr]\n"
170         "\t- run script starting at addr\n"
171         "\t- A valid image header must be present"
172 #if defined(CONFIG_FIT)
173         "\n"
174         "For FIT format uImage addr must include subimage\n"
175         "unit name in the form of addr:<subimg_uname>"
176 #endif
177         "";
178 #endif
179
180 U_BOOT_CMD(
181         source, 2, 0,   do_source,
182         "run script from memory", source_help_text
183 );
184 #endif