docker_images.h

Go to the documentation of this file.

/*
 *
 * Copyright (c) 2018-2022 Abhishek Mishra
 *
 * This file is part of clibdocker.
 *
 * clibdocker is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as 
 * published by the Free Software Foundation, 
 * either version 3 of the License, or (at your option) 
 * any later version.
 *
 * clibdocker is distributed in the hope that it will be useful, 
 * but WITHOUT ANY WARRANTY; without even the implied warranty 
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
 * See the GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public 
 * License along with clibdocker. 
 * If not, see <https://www.gnu.org/licenses/>.
 *
 */
 
#ifndef SRC_DOCKER_IMAGES_H_
#define SRC_DOCKER_IMAGES_H_
 
#ifdef __cplusplus  
extern "C" {
#endif
 
#include <coll_arraylist.h>
#include "docker_connection_util.h"
#include "docker_result.h"
#include "docker_util.h"
 
#define DEFAULT_DOCKER_FILE_NAME "Dockerfile"
 
typedef json_object                                         docker_image;
 
#define docker_image_id_get(img)                            get_attr_str((json_object*)img, "Id")
 
#define docker_image_container_get(img)                     get_attr_str((json_object*)img, "Container")
 
#define docker_image_comment_get(img)                       get_attr_str((json_object*)img, "Comment")
 
#define docker_image_os_get(img)                            get_attr_str((json_object*)img, "Os")
 
#define docker_image_architecture_get(img)                  get_attr_str((json_object*)img, "Architecture")
 
#define docker_image_parent_get(img)                        get_attr_str((json_object*)img, "Parent")
 
#define docker_image_docker_version_get(img)                get_attr_str((json_object*)img, "DockerVersion")
 
#define docker_image_virtual_size_get(img)                  get_attr_long_long((json_object*)img, "VirtualSize")
 
#define docker_image_size_get(img)                          get_attr_long_long((json_object*)img, "Size")
 
#define docker_image_author_get(img)                        get_attr_str((json_object*)img, "Author")
 
#define docker_image_created_get(img)                       get_attr_unsigned_long((json_object*)img, "Created")
 
#define docker_image_repo_tags_get(img)                     get_attr_json_object((json_object*)img, "RepoTags")
 
#define docker_image_repo_tags_length(img)                  json_object_array_length(docker_image_repo_tags_get(img))
 
#define docker_image_repo_tags_get_idx(img, i)              (char*)json_object_get_string(json_object_array_get_idx(docker_image_repo_tags_get(img), i))
 
#define docker_image_repo_digests_get(img)                  get_attr_json_object((json_object*)img, "RepoDigests")
 
#define docker_image_repo_digests_length(img)               json_object_array_length(docker_image_repo_digests_get(img))
 
#define docker_image_repo_digests_get_idx(img, i)           (char*)json_object_get_string(json_object_array_get_idx(docker_image_repo_digests_get(img), i))
 
typedef json_object                                         docker_image_list;
 
#define free_docker_image_list(image_ls)                    json_object_put(image_ls)
 
#define docker_image_list_length(image_ls)                  json_object_array_length(image_ls)
 
#define docker_image_list_get_idx(image_ls, i)              (docker_image*) json_object_array_get_idx(image_ls, i)
 
MODULE_API d_err_t docker_images_list(docker_context* ctx,
        docker_image_list** images, int all, int digests, char* filter_before,
        int filter_dangling, char* filter_label, char* filter_reference,
        char* filter_since);
 
typedef struct docker_progress_detail_t {
    long current;       
    long total;         
} docker_progress_detail;
 
typedef struct docker_image_create_status_t {
    char* status;                               
    char* id;                                   
    char* progress;                             
    docker_progress_detail* progress_detail;    
} docker_image_create_status;
 
typedef struct docker_build_status_t {
    char* stream;           
    char* aux_id;           
} docker_build_status;
 
//Docker Image Create commands
MODULE_API d_err_t docker_image_create_from_image(docker_context* ctx,
        char* from_image, char* tag, char* platform);
 
MODULE_API d_err_t docker_image_create_from_image_cb(docker_context* ctx,
        void (*status_cb)(docker_image_create_status*, void* cbargs),
        void* cbargs, char* from_image, char* tag, char* platform);
 
//error_t docker_image_create_from_src(docker_context* ctx, docker_result** res, char* from_src, char* repo, char* tag, char* platform);
 
MODULE_API d_err_t docker_image_build_cb(docker_context* ctx, 
        char* folder, char* dockerfile,
        void (*status_cb)(docker_build_status*, void* cbargs),
        void* cbargs, ...);
 
#ifdef __cplusplus 
}
#endif
 
#endif /* SRC_DOCKER_IMAGES_H_ */