Rust系统包管理库alpm-sys的使用，alpm-sys提供Arch Linux包管理系统的底层绑定与交互功能

alpm-sys是libalpm的Rust绑定库，提供了与Arch Linux包管理系统(pacman)底层交互的功能。它是alpm.rs项目的一部分，提供了对libalpm API的完整、安全且符合人体工程学的绑定。

特性

• mtree - 启用alpm_pkg_mtree_*函数
• generate - 在构建时生成原始alpm-sys绑定
• checkver - 检查安装的libalpm版本是否与alpm.rs兼容
• git - 针对git master API
• static - 静态链接libalpm

注意: checkver特性不能与git特性一起使用。可以使用generate特性来确保alpm.rs针对兼容的libalpm版本构建。

libalpm兼容性

alpm-sys始终针对最新版本的libalpm。如果API没有变化，它也可能支持以前的版本。

当前alpm-sys支持libalpm v15.x.x。

安装

在项目目录中运行以下Cargo命令:

cargo add alpm-sys

或者在Cargo.toml中添加:

alpm-sys = "4.0.3"

示例代码

以下是一个使用alpm-sys查询本地包数据库的完整示例:

use alpm_sys::*;
use std::ffi::CString;
use std::ptr;

fn main() {
    // 初始化alpm句柄
    let root = CString::new("/").unwrap();
    let dbpath = CString::new("/var/lib/pacman/").unwrap();
    let handle = unsafe { alpm_initialize(root.as_ptr(), dbpath.as_ptr(), ptr::null_mut()) };
    
    if handle.is_null() {
        eprintln!("Failed to initialize alpm");
        return;
    }

    // 获取本地数据库
    let local_db = unsafe { alpm_get_localdb(handle) };
    
    // 获取包列表
    let mut pkg_list = unsafe { alpm_db_get_pkgcache(local_db) };
    
    // 遍历包列表
    while !pkg_list.is_null() {
        let pkg = unsafe { (*pkg_list).data };
        let name = unsafe { alpm_pkg_get_name(pkg) };
        let version = unsafe { alpm_pkg_get_version(pkg) };
        
        println!("Package: {} - {}", unsafe { std::ffi::CStr::from_ptr(name).to_string_lossy() }, 
                               unsafe { std::ffi::CStr::from_ptr(version).to_string_lossy() });
        
        pkg_list = unsafe { (*pkg_list).next };
    }

    // 释放资源
    unsafe { alpm_release(handle) };
}

完整示例代码

以下是一个扩展的完整示例，展示如何查询远程仓库和安装包：

use alpm_sys::*;
use std::ffi::{CString, CStr};
use std::ptr;

fn main() {
    // 初始化alpm句柄
    let root = CString::new("/").unwrap();
    let dbpath = CString::new("/var/lib/pacman/").unwrap();
    let handle = unsafe { alpm_initialize(root.as_ptr(), dbpath.as_ptr(), ptr::null_mut()) };
    
    if handle.is_null() {
        eprintln!("Failed to initialize alpm");
        return;
    }

    // 添加core仓库
    let core_db = CString::new("core").unwrap();
    let core_url = CString::new("https://mirrors.ustc.edu.cn/archlinux/core/os/x86_64/").unwrap();
    let sig_level = ALPM_SIG_PACKAGE | ALPM_SIG_PACKAGE_OPTIONAL;
    
    unsafe {
        alpm_register_syncdb(handle, core_db.as_ptr(), sig_level as i32, core_url.as_ptr());
    }

    // 获取本地数据库
    let local_db = unsafe { alpm_get_localdb(handle) };
    
    // 获取本地包列表
    println!("=== 本地安装的包 ===");
    let mut local_pkg_list = unsafe { alpm_db_get_pkgcache(local_db) };
    while !local_pkg_list.is_null() {
        let pkg = unsafe { (*local_pkg_list).data };
        let name = unsafe { alpm_pkg_get_name(pkg) };
        let version = unsafe { alpm_pkg_get_version(pkg) };
        
        println!("{} - {}", unsafe { CStr::from_ptr(name).to_string_lossy() }, 
                            unsafe { CStr::from_ptr(version).to_string_lossy() });
        
        local_pkg_list = unsafe { (*local_pkg_list).next };
    }

    // 获取远程仓库包列表
    println!("\n=== 远程仓库中的包 ===");
    let db_list = unsafe { alpm_get_syncdbs(handle) };
    let mut db_iter = db_list;
    
    while !db_iter.is_null() {
        let db = unsafe { (*db_iter).data };
        let db_name = unsafe { alpm_db_get_name(db) };
        println!("\n仓库: {}", unsafe { CStr::from_ptr(db_name).to_string_lossy() });
        
        let mut pkg_list = unsafe { alpm_db_get_pkgcache(db) };
        while !pkg_list.is_null() {
            let pkg = unsafe { (*pkg_list).data };
            let name = unsafe { alpm_pkg_get_name(pkg) };
            let version = unsafe { alpm_pkg_get_version(pkg) };
            
            println!("{} - {}", unsafe { CStr::from_ptr(name).to_string_lossy() }, 
                                unsafe { CStr::from_ptr(version).to_string_lossy() });
            
            pkg_list = unsafe { (*pkg_list).next };
        }
        
        db_iter = unsafe { (*db_iter).next };
    }

    // 释放资源
    unsafe { alpm_release(handle) };
}

文档

alpm-sys只是提供了libalpm的绑定，因此不包含libalpm本身的文档。可以在libalpm(3)手册页或alpm.h中找到libalpm的文档。