removexattr系统调用及示例

我们来学习一下 removexattr 这个函数。它是 Linux 中用于管理扩展属性（Extended Attributes, xattrs）的一组函数之一。

1. 函数介绍

removexattr 是一个 Linux 系统调用（System Call），它的作用是删除与文件或目录相关联的扩展属性（Extended Attribute） 。

想象一下标准的文件属性：所有者、权限、大小、修改时间等。扩展属性则允许你为文件或目录附加一些额外的、用户自定义的“标签”或“元数据”（metadata）。这些属性以键值对（key-value pair）的形式存在，键（name）是一个字符串，值（value）是一段任意数据。

removexattr 函数就是用来移除这些自定义键值对中的某一个键（及其对应的值）的。它的使用场景包括清理不再需要的自定义元数据、实现特定应用程序的数据存储需求、或在安全/访问控制策略中移除标记等 。

2. 函数原型

#include <sys/xattr.h> // 包含扩展属性相关的函数和常量

int removexattr(const char *path, const char *name);
int lremovexattr(const char *path, const char *name);
int fremovexattr(int fd, const char *name);

3. 功能

这个函数族的功能是删除指定文件或目录上的一个特定扩展属性。

• removexattr: 通过文件路径删除扩展属性。如果路径指向符号链接（symlink），它会作用于符号链接指向的目标文件。
• lremovexattr: 通过文件路径删除扩展属性。如果路径指向符号链接，它会作用于符号链接本身，而不是其目标。
• fremovexattr: 通过已打开文件的文件描述符（file descriptor）删除扩展属性。

4. 参数

这三个函数的参数非常相似：

• path (对于 removexattr 和 lremovexattr):
  • const char * 类型。
  • 指向一个以 null 结尾的字符串，表示要操作的文件或目录的路径名 。
• fd (对于 fremovexattr):
  • int 类型。
  • 一个已打开文件的有效文件描述符 。
• name:
  • const char * 类型。
  • 指向一个以 null 结尾的字符串，表示要删除的扩展属性的名称（键）。这个名称通常包含一个命名空间前缀，例如 "user.my_custom_flag" 或 "trusted.my_security_label"。

5. 返回值

• 成功: 返回 0。
• 失败: 返回 -1，并设置全局变量 errno 来指示具体的错误类型 。
  • ENOATTR 或 ENODATA: 表示指定的属性名不存在。
  • EACCES 或 EPERM: 权限不足，无法删除该属性。
  • ENOTDIR: path 的某个前缀不是目录。
  • ENAMETOOLONG: path 或 name 太长。
  • ENOENT: 文件或路径不存在。
  • ELOOP: path 解析时遇到符号链接循环。
  • EFAULT: path 或 name 指向无效的地址空间。
  • EIO: I/O 错误。
  • ENOMEM: 内核内存不足。
  • EROFS: 文件系统是只读的。

6. 相似函数或关联函数

• setxattr / lsetxattr / fsetxattr: 用于设置或创建扩展属性。
• getxattr / lgetxattr / fgetxattr: 用于获取扩展属性的值。
• listxattr / llistxattr / flistxattr: 用于列出文件或目录上所有扩展属性的名称。
• <sys/xattr.h>: 包含所有扩展属性相关函数和常量定义的头文件。

7. 示例代码

这个示例将演示如何使用 setxattr 设置一个扩展属性，然后使用 removexattr 删除它。

前提: 文件系统需要支持扩展属性（大多数现代 Linux 文件系统如 ext4, XFS 都支持）。运行示例可能需要适当权限。

#include <stdio.h>
#include <unistd.h>
#include <sys/xattr.h> // 扩展属性函数
#include <string.h>
#include <errno.h>

int main() {
    const char *filename = "example_file.txt";
    const char *attr_name = "user.example_key"; // 使用 user 命名空间
    const char *attr_value = "This is example data for the attribute.";
    size_t value_size = strlen(attr_value);
    char buffer[1024];
    ssize_t get_result;
    int remove_result;

    // 1. 创建一个示例文件 (如果不存在)
    FILE *file = fopen(filename, "w");
    if (!file) {
        perror("fopen");
        return 1;
    }
    fprintf(file, "Hello, this is a test file for xattrs.\n");
    fclose(file);

    // 2. 设置一个扩展属性
    printf("Setting extended attribute '%s' on file '%s'...\n", attr_name, filename);
    if (setxattr(filename, attr_name, attr_value, value_size, 0) == -1) {
        perror("setxattr");
        fprintf(stderr, "Failed to set attribute '%s'.\n", attr_name);
        return 1;
    }
    printf("Attribute '%s' set successfully.\n", attr_name);

    // 3. 验证属性已设置 (可选)
    printf("Verifying attribute '%s' exists...\n", attr_name);
    get_result = getxattr(filename, attr_name, buffer, sizeof(buffer) - 1);
    if (get_result == -1) {
        perror("getxattr (verification)");
        fprintf(stderr, "Failed to verify attribute '%s'.\n", attr_name);
        return 1;
    }
    buffer[get_result] = '\0'; // Null-terminate for printing
    printf("Attribute '%s' value is: '%s'\n", attr_name, buffer);

    // 4. 删除扩展属性
    printf("Removing extended attribute '%s' from file '%s'...\n", attr_name, filename);
    remove_result = removexattr(filename, attr_name);
    if (remove_result == -1) {
        perror("removexattr");
        fprintf(stderr, "Failed to remove attribute '%s'.\n", attr_name);
        // 检查是否是因为属性不存在
        if (errno == ENOATTR || errno == ENODATA) {
             printf("Note: The attribute might not have existed.\n");
        }
        return 1;
    }
    printf("Attribute '%s' removed successfully.\n", attr_name);

    // 5. 验证属性已删除 (可选)
    printf("Verifying attribute '%s' is removed...\n", attr_name);
    get_result = getxattr(filename, attr_name, buffer, sizeof(buffer) - 1);
    if (get_result == -1) {
        if (errno == ENOATTR || errno == ENODATA) {
            printf("Confirmed: Attribute '%s' no longer exists on '%s'.\n", attr_name, filename);
        } else {
            perror("getxattr (verification after removal)");
            fprintf(stderr, "Error occurred while verifying removal of '%s'.\n", attr_name);
            return 1;
        }
    } else {
         buffer[get_result] = '\0';
         printf("Unexpected: Attribute '%s' still seems to exist with value '%s'.\n", attr_name, buffer);
         return 1;
    }

    // 6. 清理示例文件 (可选)
    // if (remove(filename) != 0) {
    //     perror("remove");
    //     fprintf(stderr, "Warning: Could not remove example file '%s'.\n", filename);
    // } else {
    //     printf("Removed example file '%s'.\n", filename);
    // }

    return 0;
}

编译和运行:

# 假设代码保存在 xattr_example.c 中
gcc -o xattr_example xattr_example.c

# 运行
./xattr_example

# 你也可以使用命令行工具 `setfattr` 和 `getfattr` 来验证
# touch test_file
# setfattr -n user.test_key -v "test_value" test_file
# getfattr -n user.test_key test_file
# attr -r user.test_key test_file # 删除属性
# getfattr -n user.test_key test_file # 再次检查应该报错或无输出

removexattr系统调用及示例-CSDN博客

removexattr系统调用及示例

remap_file_pages系统调用及示例-CSDN博客