用 C 语言获取文件的扩展属性

Jinku Hu 2023年1月30日 2021年3月21日
  1. 使用 getxattrlistxattr 函数获取文件的扩展属性
  2. 使用 setxattr 函数来设置文件的扩展属性
用 C 语言获取文件的扩展属性

本文将介绍几种如何在 C 语言中获取文件扩展属性的方法。

使用 getxattrlistxattr 函数获取文件的扩展属性

一些基于 UNIX 的系统为文件提供扩展的属性,表示可以与文件关联的元数据的名称/值对。扩展属性需要基础文件系统支持,但是常见文件系统类型具有此功能。扩展属性具有 namespace.name 类型的特定格式,其中 namespace 用于对功能相似的分组,而 name 部分则标识单个扩展属性。命名空间可以具有以下值:usertrustedsystemsecurity,作为一种惯例,它们区分了几种权限类型(在这里有详细描述)。在这种情况下,我们实现了一个例子程序,该程序将多个文件名用作命令行参数,并因此为每个文件检索所有扩展属性。请注意,该程序使用 getopt 函数处理多个文件参数。

getxattr 函数采用四个参数来检索扩展的属性值。第一个参数指定文件系统中的路径,以指示应为其检索 EA 的文件,第二个参数指定属性名称。最后两个参数是指向由 getxattr 存储值的位置的指针,以及该地址上可用的缓冲区大小。请注意,可以通过将值 0 作为大小参数传递来检索属性值的大小,并且调用的返回值是所需缓冲区的字节数。尽管在调用第二个调用以检索该值时,它可能会更改并且大小不同;因此,最好检查错误代码以确保无误执行。

另一方面,listxattr 函数检索给定文件路径的扩展属性名称列表。它包含三个参数,第一个是文件路径。接下来的两个参数表示将存储检索到的列表的缓冲区,缓冲区的大小以字节为单位。请注意,此缓冲区是由调用方分配的,并且调用方负责分配足够的内存。同样,类似于 getxattr,可以将值 0 作为该函数的第三个参数传递,返回值将是存储完整列表所需的缓冲区大小。

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <stdbool.h>
#include <sys/xattr.h>

#define XATTR_SIZE 10000

#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \
                               } while (0)


static void usageError(char *progName)
{
    fprintf(stderr, "Usage: %s [-x] file...\n", progName);
    exit(EXIT_FAILURE);
}

int main(int argc, char *argv[]) {
    char list[XATTR_SIZE], value[XATTR_SIZE];
    ssize_t listLen, valueLen;
    int ns, j, k, opt;
    bool hexDisplay;

    hexDisplay = 0;
    while ((opt = getopt(argc, argv, "x")) != -1) {
        switch (opt) {
            case 'x': hexDisplay = 1; break;
            case '?': usageError(argv[0]);
        }
    }

    if (optind >= argc)
        usageError(argv[0]);

    for (j = optind; j < argc; j++) {
        listLen = listxattr(argv[j], list, XATTR_SIZE);
        if (listLen == -1)
            errExit("listxattr");

        printf("%s:\n", argv[j]);

        for (ns = 0; ns < listLen; ns += strlen(&list[ns]) + 1) {
            printf("        name=%s; ", &list[ns]);

            valueLen = getxattr(argv[j], &list[ns], value, XATTR_SIZE);
            if (valueLen == -1) {
                printf("couldn't get value");
            } else if (!hexDisplay) {
                printf("value=%.*s", (int) valueLen, value);
            } else {
                printf("value=");
                for (k = 0; k < valueLen; k++)
                    printf("%02x ", (unsigned char) value[k]);
            }

            printf("\n");
        }

        printf("\n");
    }

    exit(EXIT_SUCCESS);
}

使用 setxattr 函数来设置文件的扩展属性

另外,我们可以使用 setxattr 函数为文件设置任意属性,该函数将文件的路径名,名称/值对作为单独的参数,值的大小,一个整数,该整数指定不同设置操作的预定义值。如果最后一个参数为零(默认值),则扩展属性(如果不存在)将创建;否则,扩展属性将被创建。否则,将替换该值。可以指定 XATTR_CREATE 宏以指示仅创建选项,如果该属性存在则将失败,而可以指定 XATTR_REPLACE 进行替换,如果该属性不存在则将失败。

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/xattr.h>


#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \
                               } while (0)


static void usageError(char *progName)
{
    fprintf(stderr, "Usage: %s file\n", progName);
    exit(EXIT_FAILURE);
}

int main(int argc, char *argv[]) {
    char *value;

    if (argc < 2 || strcmp(argv[1], "--help") == 0)
        usageError(argv[0]);

    value = "x attribute value";
    if (setxattr(argv[1], "user.x", value, strlen(value), 0) == -1)
        errExit("setxattr");

    value = "y attribute value";
    if (setxattr(argv[1], "user.y", value, strlen(value), 0) == -1)
        errExit("setxattr");

    exit(EXIT_SUCCESS);
}
Author: Jinku Hu
Jinku Hu avatar Jinku Hu avatar

Founder of DelftStack.com. Jinku has worked in the robotics and automotive industries for over 8 years. He sharpened his coding skills when he needed to do the automatic testing, data collection from remote servers and report creation from the endurance test. He is from an electrical/electronics engineering background but has expanded his interest to embedded electronics, embedded programming and front-/back-end programming.

LinkedIn

相关文章 - C File