HOWTO · C
在 C 语言中创建一个新目录
本文介绍了如何在 C 语言中创建新目录
本页内容
使用 POSIX 函数 mkdir,即可直接在 C 程序中创建一个目录。它接收路径名和权限位,并通过返回值及 errno 报告失败。请求的权限会受到进程 umask 的过滤,因此最终模式可能比传给函数的模式限制更多。如果需要相对于某个已打开的目录,而不是相对于进程当前工作目录来解析路径名,可以使用 mkdirat。
使用 mkdir 创建目录
使用 mkdir 时,请包含 <sys/stat.h>。第一个参数是新目录的路径;第二个参数是权限模式,例如 0750。在此模式下,所有者可以读取、写入和搜索该目录;所属组的成员可以读取和搜索该目录。其他用户不会获得这些请求权限位所授予的权限。进程的 umask 可以移除权限,但不能增加权限。
运行下面的示例。代码中的标签和输出文字保持英文。
本节中的代码以及显示的标签或输出仍为英文。
#define _POSIX_C_SOURCE 200809L
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <unistd.h>
int main(void) {
char parent[] = "/tmp/mkdir-demo-XXXXXX";
char path[sizeof(parent) + sizeof("/reports")];
if (mkdtemp(parent) == NULL) {
perror("mkdtemp");
return EXIT_FAILURE;
}
int path_length = snprintf(path, sizeof(path), "%s/reports", parent);
if (path_length < 0 || (size_t)path_length >= sizeof(path)) {
puts("path formatting failed");
if (rmdir(parent) == -1) {
perror("rmdir parent");
}
return EXIT_FAILURE;
}
if (mkdir(path, 0750) == -1) {
perror("mkdir");
if (rmdir(parent) == -1) {
perror("rmdir parent");
}
return EXIT_FAILURE;
}
puts("Created reports directory.");
int result = EXIT_SUCCESS;
if (rmdir(path) == -1) {
perror("rmdir child");
result = EXIT_FAILURE;
}
if (rmdir(parent) == -1) {
perror("rmdir parent");
result = EXIT_FAILURE;
}
return result;
}
Created reports directory.
提供的运行记录显示,成功案例会打印 Created reports directory.;该记录没有包含失败案例。此示例会创建一个临时父目录,在其中创建 reports,打印成功消息,然后删除这两个目录。在自己的应用程序中,请将临时路径名换成所需位置,并判断所选权限是否适合存放在该目录中的数据。
处理错误和已存在的路径
mkdir 成功时返回 0,失败时返回 -1。失败时,它会设置 errno;请及时调用 perror,或在进行其他可能改变 errno 的操作前保存其值。常见原因包括父目录不存在、没有修改父目录的权限、路径名超过系统限制,或路径中的某个组成部分不是目录。如果目标已经存在,mkdir 也会以 EEXIST 失败;无论目标是目录还是其他类型的文件,都是如此。
应以创建操作的结果为准。在调用 mkdir 之前使用 stat 检查,并不能保证该路径在创建时仍不存在:其他进程可能在检查与调用之间创建它。如果程序允许把已存在的目录视为成功,请处理 EEXIST,随后用 stat 或 lstat 检查路径类型;如果路径可能被并发更改,也要考虑竞态。不要默默接受已存在的普通文件。
0750 是请求的模式,不一定是最终模式。例如,限制较严的 umask 可能清除组或所有者的权限位。如果必须确保权限完全符合要求,请检查创建后目录的模式,并有意实施权限策略;如果其他进程可能已替换该路径,更改权限时还要考虑安全影响。
使用 mkdirat 相对于已打开的目录创建目录
mkdirat 接收目录文件描述符、路径名和模式。路径名为相对路径时,内核会从该目录描述符所指的目录解析路径,不受进程当前工作目录之后发生变化的影响。如果应用程序已经打开一个目录,并希望后续操作以该目录为基准,这种方式就很有用。绝对路径不会相对于该描述符解析。
此示例会打开一个临时父目录,相对于其描述符创建子目录,然后关闭该描述符。之后会删除临时目录。提供的运行记录显示,成功案例执行完毕且没有标准输出;记录没有报告失败案例的执行情况。代码中的标签保持英文。
本节中的代码以及显示的标签或输出仍为英文。
#define _POSIX_C_SOURCE 200809L
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <unistd.h>
int main(void) {
char parent[] = "/tmp/mkdirat-demo-XXXXXX";
char child[sizeof(parent) + sizeof("/reports")];
int dirfd;
int result = EXIT_FAILURE;
int created = 0;
if (mkdtemp(parent) == NULL) {
perror("mkdtemp");
return EXIT_FAILURE;
}
dirfd = open(parent, O_RDONLY);
if (dirfd == -1) {
perror("open");
if (rmdir(parent) == -1) {
perror("rmdir parent");
}
return EXIT_FAILURE;
}
if (mkdirat(dirfd, "reports", 0750) == -1) {
perror("mkdirat");
} else {
created = 1;
result = EXIT_SUCCESS;
}
if (close(dirfd) == -1) {
perror("close");
result = EXIT_FAILURE;
}
if (created) {
int child_length = snprintf(child, sizeof(child), "%s/reports", parent);
if (child_length < 0 || (size_t)child_length >= sizeof(child)) {
puts("path formatting failed");
result = EXIT_FAILURE;
} else {
if (rmdir(child) == -1) {
perror("rmdir child");
result = EXIT_FAILURE;
}
}
}
if (rmdir(parent) == -1) {
perror("rmdir parent");
result = EXIT_FAILURE;
}
return result;
}
在需要使用描述符期间保持其打开,并确保在所有执行路径上都将其关闭。在生产代码中,清理操作只能删除由程序创建的对象。对于安全敏感的操作,可以考虑使用适合平台的标志打开目录,并验证要使用的目录;mkdirat 可以锚定相对路径解析,但本身并不会验证所提供路径名中的每个组成部分。
为什么创建目录时应避免使用 system()
当 C 已经提供 mkdir 时,通常没有必要调用 system() 来运行 shell 命令。这会增加启动 shell 和解释命令的开销;如果根据路径构建命令字符串,不可信路径中的 shell 元字符还可能改变实际执行的命令。要在不同 shell 中正确引用路径也很困难。请直接调用 mkdir 或 mkdirat,检查结果,并报告 errno。只有当应用程序确实需要 shell 行为,并通过独立且经过仔细设计的安全策略处理命令构造和执行时,才适合使用 shell。