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

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

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

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

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

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

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

#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/xattr.h>
#include <unistd.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);
}
作者: Jinku Hu
Jinku Hu avatar Jinku Hu avatar

DelftStack.com 创始人。Jinku 在机器人和汽车行业工作了8多年。他在自动测试、远程测试及从耐久性测试中创建报告时磨练了自己的编程技能。他拥有电气/电子工程背景,但他也扩展了自己的兴趣到嵌入式电子、嵌入式编程以及前端和后端编程。

LinkedIn Facebook

相关文章 - C File