Open Ethernet Networking (OpEN) API Guide and Reference Manual  3.6.0.3
openapi_image.h
Go to the documentation of this file.
1 
9 /*********************************************************************
10 *
11 * Copyright 2016-2018 Broadcom
12 *
13 * Licensed under the Apache License, Version 2.0 (the "License");
14 * you may not use this file except in compliance with the License.
15 * You may obtain a copy of the License at
16 *
17 * http://www.apache.org/licenses/LICENSE-2.0
18 *
19 * Unless required by applicable law or agreed to in writing, software
20 * distributed under the License is distributed on an "AS IS" BASIS,
21 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
22 * See the License for the specific language governing permissions and
23 * limitations under the License.
24 *
25 **********************************************************************
26 *
27 * @filename openapi_image.h
28 *
29 * @purpose Image Management and Configuration
30 *
31 * @component OpEN
32 *
33 * @create 11/13/2015
34 *
35 * @end
36 *
37 **********************************************************************/
38 #ifndef OPENAPI_IMAGE_H_INCLUDED
39 #define OPENAPI_IMAGE_H_INCLUDED
40 
41 #include "openapi_common.h"
42 
43 #define OPEN_UBOOT_VERSION_LENGTH 17 /* UBOOT_VERSION_LENGTH + 1 */
44 
45 #define OPEN_IMAGE_NAME_NONE "none"
46 
47 /*****************************************************************/
65  uint32_t unit);
66 
67 /*****************************************************************/
90  uint32_t unit,
91  open_buffdesc *imageLabel,
92  OPEN_BOOL_t updateBootCode);
93 
94 /*****************************************************************/
119  uint32_t unit,
120  open_buffdesc *imageLabel);
121 
122 /*****************************************************************/
140  open_buffdesc *imageLabel,
141  open_buffdesc *imageDescr);
142 
143 /*****************************************************************/
164  open_buffdesc *imageLabel,
165  open_buffdesc *imageDescr);
166 
167 /*****************************************************************/
203  open_buffdesc *imageLabel,
204  OPEN_BOOL_t *isValid);
205 
206 /*****************************************************************/
227  open_buffdesc *activeLabel,
228  open_buffdesc *backupLabel);
229 
230 /*****************************************************************/
255  uint32_t unit,
256  open_buffdesc *activeImage,
257  open_buffdesc *backupImage,
258  open_buffdesc *activatedImage);
259 
260 /*****************************************************************/
289  open_buffdesc *imagePath,
290  open_buffdesc *imageLabel);
291 
292 /*****************************************************************/
306  open_buffdesc *version);
307 
308 #endif /* OPENAPI_IMAGE_H_INCLUDED */
309 
open_error_t openapiImageUpgrade(openapiClientHandle_t *client_handle, open_buffdesc *imagePath, open_buffdesc *imageLabel)
Get a locally copied image path, perform validation on it and on success, upgrade the switch with thi...
open_error_t openapiImageActivate(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *imageLabel, OPEN_BOOL_t updateBootCode)
Sets the specified image as the active image for the subsequent re-boots.
open_error_t openapiBootCodeVersion(openapiClientHandle_t *client_handle, open_buffdesc *version)
Gets the boot code version from the current active image.
open_error_t openapiImageLabelsGet(openapiClientHandle_t *client_handle, open_buffdesc *activeLabel, open_buffdesc *backupLabel)
Get the label names for both active and backup images.
open_error_t
OPEN uses these enumerators to indicate the error codes.
open_error_t openapiImageNamesGet(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *activeImage, open_buffdesc *backupImage, open_buffdesc *activatedImage)
Get the image names for both active, backup, and activated.
open_error_t openapiImageDelete(openapiClientHandle_t *client_handle, uint32_t unit, open_buffdesc *imageLabel)
Deletes the specified image.
OPEN_BOOL_t
OPEN uses these enumerators to indicate true or false for a given config or status parameter...
open_error_t openapiBootCodeUpdate(openapiClientHandle_t *client_handle, uint32_t unit)
Updates the bootcode from the currently activated image.
open_error_t openapiImageDescrGet(openapiClientHandle_t *client_handle, open_buffdesc *imageLabel, open_buffdesc *imageDescr)
Get the text description for a given image.
open_error_t openapiImageDescrSet(openapiClientHandle_t *client_handle, open_buffdesc *imageLabel, open_buffdesc *imageDescr)
Set the text description for a given image.
open_error_t openapiImageLabelIsValid(openapiClientHandle_t *client_handle, open_buffdesc *imageLabel, OPEN_BOOL_t *isValid)
Determines if the image label refers to a valid image name.