|
3 | 3 | * |
4 | 4 | * Copyright (c) 2017-2019 Linaro LTD |
5 | 5 | * Copyright (c) 2016-2019 JUUL Labs |
6 | | - * Copyright (c) 2019-2020 Arm Limited |
| 6 | + * Copyright (c) 2019-2021 Arm Limited |
7 | 7 | * Copyright (c) 2020 Nordic Semiconductor ASA |
8 | 8 | * |
9 | 9 | * Original license: |
@@ -147,25 +147,54 @@ int boot_swap_type_multi(int image_index); |
147 | 147 | int boot_swap_type(void); |
148 | 148 |
|
149 | 149 | /** |
150 | | - * Marks the image in the secondary slot as pending. On the next reboot, |
151 | | - * the system will perform a one-time boot of the the secondary slot image. |
| 150 | + * Marks the image with the given index in the secondary slot as pending. On the |
| 151 | + * next reboot, the system will perform a one-time boot of the the secondary |
| 152 | + * slot image. |
152 | 153 | * |
153 | | - * @param permanent Whether the image should be used permanently or |
154 | | - * only tested once: |
155 | | - * 0=run image once, then confirm or revert. |
156 | | - * 1=run image forever. |
| 154 | + * @param image_index Image pair index. |
157 | 155 | * |
158 | | - * @return 0 on success; nonzero on failure. |
| 156 | + * @param permanent Whether the image should be used permanently or |
| 157 | + * only tested once: |
| 158 | + * 0=run image once, then confirm or revert. |
| 159 | + * 1=run image forever. |
| 160 | + * |
| 161 | + * @return 0 on success; nonzero on failure. |
| 162 | + */ |
| 163 | +int boot_set_pending_multi(int image_index, int permanent); |
| 164 | + |
| 165 | +/** |
| 166 | + * Marks the image with index 0 in the secondary slot as pending. On the next |
| 167 | + * reboot, the system will perform a one-time boot of the the secondary slot |
| 168 | + * image. Note that this API is kept for compatibility. The |
| 169 | + * boot_set_pending_multi() API is recommended. |
| 170 | + * |
| 171 | + * @param permanent Whether the image should be used permanently or |
| 172 | + * only tested once: |
| 173 | + * 0=run image once, then confirm or revert. |
| 174 | + * 1=run image forever. |
| 175 | + * |
| 176 | + * @return 0 on success; nonzero on failure. |
159 | 177 | */ |
160 | 178 | int boot_set_pending(int permanent); |
161 | 179 |
|
162 | 180 | /** |
163 | | - * @brief Marks the image in the primary slot as confirmed. |
| 181 | + * Marks the image with the given index in the primary slot as confirmed. The |
| 182 | + * system will continue booting into the image in the primary slot until told to |
| 183 | + * boot from a different slot. |
164 | 184 | * |
165 | | - * The system will continue booting into the image in the primary slot until |
166 | | - * told to boot from a different slot. |
| 185 | + * @param image_index Image pair index. |
167 | 186 | * |
168 | | - * @return 0 on success; nonzero on failure. |
| 187 | + * @return 0 on success; nonzero on failure. |
| 188 | + */ |
| 189 | +int boot_set_confirmed_multi(int image_index); |
| 190 | + |
| 191 | +/** |
| 192 | + * Marks the image with index 0 in the primary slot as confirmed. The system |
| 193 | + * will continue booting into the image in the primary slot until told to boot |
| 194 | + * from a different slot. Note that this API is kept for compatibility. The |
| 195 | + * boot_set_confirmed_multi() API is recommended. |
| 196 | + * |
| 197 | + * @return 0 on success; nonzero on failure. |
169 | 198 | */ |
170 | 199 | int boot_set_confirmed(void); |
171 | 200 |
|
|
0 commit comments