Struct TarUtils

pub struct TarUtils;

Tar processing utilities for layer extraction and offset calculation

Implementations

impl TarUtils

pub fn extract_layer_data(tar_path: &Path, layer_path: &str) -> Result<Vec<u8>>

Extract layer data from tar archive

重要：直接返回tar中的原始layer数据，保持Docker兼容性 Docker镜像中的层已经是正确的gzip格式

pub fn find_layer_offset(tar_path: &Path, layer_path: &str) -> Result<u64>

Find the offset of a layer within the tar archive

pub fn list_tar_entries(tar_path: &Path) -> Result<Vec<(String, u64)>>

Get a list of all entries in the tar archive with their sizes

pub fn validate_tar_archive(tar_path: &Path) -> Result<()>

Validate that a tar archive is readable and properly formatted

pub fn extract_manifest(tar_path: &Path) -> Result<String>

从 tar 文件中提取镜像清单

解析 Docker 镜像 tar 文件，提取 manifest.json 内容

pub fn extract_config(tar_path: &Path, config_path: &str) -> Result<String>

从 tar 文件中提取镜像配置

解析 Docker 镜像 tar 文件，提取指定的配置文件内容

pub fn extract_config_data( tar_path: &Path, config_digest: &str, ) -> Result<Vec<u8>>

从 tar 文件中提取镜像配置数据为字节数组

pub fn parse_image_info(tar_path: &Path) -> Result<ImageInfo>

解析 tar 文件获取完整的镜像信息

pub async fn extract_layer_data_streaming( tar_path: &Path, layer_path: &str, ) -> Result<Vec<u8>>

Extract layer data using streaming approach for memory efficiency

This method streams data in chunks to avoid loading large files entirely into memory

pub fn extract_layer_data_limited( tar_path: &Path, layer_path: &str, max_size: u64, ) -> Result<Vec<u8>>

Extract layer data with size limit to prevent memory exhaustion