# 15.1. `os` — 操作系统接口模块

该模块提供了一些方便使用操作系统相关功能的函数。 如果你是想读写一个文件，请参阅 `open()`，如果你想操作路径，请参阅 `os.path` 模块，如果你想在命令行上读取所有文件中的所有行请参阅 `fileinput` 模块。 有关创建临时文件和目录的方法，请参阅 `tempfile` 模块，对于高级文件目录处理，请参阅 `shutil` 模块。

关于这些函数的适用性的说明：

- 所有 Python 内建的操作系统相关的模块的设计都是为了使得在同一功能可用的情况下，保持接口的一致性；例如，函数 `os.stat(path)` 以相同的格式返回关于 path 的统计信息（这个函数同时也是起源于 POSIX 接口）。

- 针对特定的操作的拓展同样在可用于 `os` 模块，但是使用它们必然会对可移植性产生威胁。

- An “Availability: Unix” note means that this function is commonly found on Unix systems. It does not make any claims about its existence on a specific operating system.

- If not separately noted, all functions that claim “Availability: Unix” are supported on Mac OS X, which builds on a Unix core.

注解

All functions in this module raise `OSError` in the case of invalid or inaccessible file names and paths, or other arguments that have the correct type, but are not accepted by the operating system.

exception `os.``error`

  内建的 `OSError` 异常的一个别名。

`os.``name`

  The name of the operating system dependent module imported. The following names have currently been registered: `'posix'`, `'nt'`, `'os2'`, `'ce'`, `'java'`, `'riscos'`.

  参见

  `sys.platform` 有更详细的描述. `os.uname()` 只给出系统提供的版本信息。

  `platform` 模块对系统的标识有更详细的检查。

## 15.1.1. 进程参数

这些函数和数据项提供了操作当前进程和用户的信息。

`os.``environ`

  一个表示字符串环境的 mapping 对象。 例如，`environ['HOME']` 是你的主目录（在某些平台上）的路径名，相当于 C 中的 `getenv("HOME")`。

  这个映射是在第一次导入 `os` 模块时捕获的，通常作为 Python 启动时处理 `site.py` 的一部分。除了通过直接修改 `os.environ` 之外，在此之后对环境所做的更改不会反映在 `os.environ` 中。

  如果平台支持 `putenv()` 函数，这个映射除了可以用于查询环境外还能用于修改环境。 当这个映射被修改时，`putenv()` 将被自动调用。

  注解

  直接调用 `putenv()` 并不会影响 `os.environ`，所以推荐直接修改``os.environ``。

  注解

  在某些平台上，包括 FreeBSD 和 Mac OS X，设置 `environ` 可能导致内存泄露。参阅 `putenv()` 的系统文档。

  如果平台没有提供 `putenv()`, 为了使启动的子进程使用修改后的环境，一份修改后的映射会被传给合适的进程创建函数。

  如果平台支持 `unsetenv()` 函数，你可以通过删除映射中元素的方式来删除对应的环境变量。当一个元素被从 `os.environ` 删除时，以及 `pop()` 或 `clear()` 被调用时， `unsetenv()` 会被自动调用。

  在 2.6 版更改: Also unset environment variables when calling `os.environ.clear()` and `os.environ.pop()`.

`os.``chdir`(path)
`os.``fchdir`(fd)
`os.``getcwd`()

  以上函数请参阅 文件和目录 。

`os.``ctermid`()

  返回与进程控制终端对应的文件名。

  Availability: Unix.

`os.``getegid`()

  返回当前进程的有效组ID。对应当前进程执行文件的 “set id” 位。

  Availability: Unix.

`os.``geteuid`()

  返回当前进程的有效用户ID。

  Availability: Unix.

`os.``getgid`()

  返回当前进程的实际组ID。

  Availability: Unix.

`os.``getgroups`()

  返回当前进程关联的附加组ID列表

  Availability: Unix.

  注解

  在Mac OS X系统中，`getgroups()` 会和其他 Unix 平台有些不同。如果 Python 解释器是在 `10.5` 或更早版本中部署，`getgroups()` 返回当前用户进程相关的有效组ID列表。 该列表长度由于系统预设的接口限制，最长为 16。 而且在适当的权限下，返回结果还会因 `getgroups()` 而发生变化；如果 Python 解释器是在 `10.5` 以上版本中部署，`getgroups()` 返回进程所属有效用户 ID 所对应的用户的组 ID 列表，组用户列表可能因为进程的生存周期而发生变动，而且也不会因为 `setgroups()` 的调用而发生，返回的组用户列表长度也没有长度 16 的限制。在部署中，Python 解释器用到的变量 `MACOSX_DEPLOYMENT_TARGET` 可以用 `sysconfig.get_config_var()`。

`os.``initgroups`(username, gid)

  调用系统 initgroups()，使用指定用户所在的所有值来初始化组访问列表，包括指定的组ID。

  Availability: Unix.

  2.7 新版功能.

`os.``getlogin`()

  Return the name of the user logged in on the controlling terminal of the process. For most purposes, it is more useful to use the environment variable `LOGNAME` to find out who the user is, or `pwd.getpwuid(os.getuid())[0]` to get the login name of the process’s real user id.

  Availability: Unix.

`os.``getpgid`(pid)

  根据进程id pid 返回进程的组 ID 列表。如果 pid 为 0，则返回当前进程的进程组 ID 列表

  Availability: Unix.

  2.3 新版功能.

`os.``getpgrp`()

  返回当时进程组的ID

  Availability: Unix.

`os.``getpid`()

  返回当前进程ID

  Availability: Unix, Windows.

`os.``getppid`()

  Return the parent’s process id.

  Availability: Unix.

`os.``getresuid`()

  返回一个由 (ruid, euid, suid) 所组成的元组，分别表示当前进程的真实用户ID，有效用户ID和暂存用户ID。

  Availability: Unix.

  2.7 新版功能.

`os.``getresgid`()

  返回一个由 (rgid, egid, sgid) 所组成的元组，分别表示当前进程的真实组ID，有效组ID和暂存组ID。

  Availability: Unix.

  2.7 新版功能.

`os.``getuid`()

  返回当前进程的真实用户ID。

  Availability: Unix.

`os.``getenv`(varname[, value])

  Return the value of the environment variable varname if it exists, or value if it doesn’t. value defaults to `None`.

  Availability: most flavors of Unix, Windows.

`os.``putenv`(varname, value)

  Set the environment variable named varname to the string value. Such changes to the environment affect subprocesses started with `os.system()`, `popen()` or `fork()` and `execv()`.

  Availability: most flavors of Unix, Windows.

  注解

  在一些平台，包括 FreeBSD 和 Mac OS X，设置 `environ` 可能导致内存泄露。详情参考 putenv 相关系统文档。

  当系统支持 `putenv()` 时，`os.environ` 中的参数赋值会自动转换为对 `putenv()` 的调用。不过 `putenv()` 的调用不会更新 `os.environ`，因此最好使用 `os.environ` 对变量赋值。

`os.``setegid`(egid)

  设置当前进程的有效组ID。

  Availability: Unix.

`os.``seteuid`(euid)

  设置当前进程的有效用户ID。

  Availability: Unix.

`os.``setgid`(gid)

  设置当前进程的组ID。

  Availability: Unix.

`os.``setgroups`(groups)

  将 group 参数值设置为与当进程相关联的附加组ID列表。group 参数必须为一个序列，每个元素应为每个组的数字ID。该操作通常只适用于超级用户。

  Availability: Unix.

  2.2 新版功能.

  注解

  在 Mac OS X 中，groups 的长度不能超过系统定义的最大有效组 ID 个数，一般为 16。 如果它没有返回与调用 setgroups() 所设置的相同的组列表，请参阅 `getgroups()` 的文档。

`os.``setpgrp`()

  根据已实现的版本（如果有）来调用系统 `setpgrp()` 或 `setpgrp(0, 0)` 。相关说明，请参考 Unix 手册。

  Availability: Unix.

`os.``setpgid`(pid, pgrp)

  使用系统调用 `setpgid()`，将 pid 对应进程的组ID设置为 pgrp。相关说明，请参考 Unix 手册。

  Availability: Unix.

`os.``setregid`(rgid, egid)

  设置当前进程的真实和有效组ID。

  Availability: Unix.

`os.``setresgid`(rgid, egid, sgid)

  设置当前进程的真实，有效和暂存组ID。

  Availability: Unix.

  2.7 新版功能.

`os.``setresuid`(ruid, euid, suid)

  设置当前进程的真实，有效和暂存用户ID。

  Availability: Unix.

  2.7 新版功能.

`os.``setreuid`(ruid, euid)

  设置当前进程的真实和有效用户ID。

  Availability: Unix.

`os.``getsid`(pid)

  调用系统调用 `getsid()`。 相关语义请参阅 Unix 手册。

  Availability: Unix.

  2.4 新版功能.

`os.``setsid`()

  使用系统调用 `getsid()`。相关说明，请参考 Unix 手册。

  Availability: Unix.

`os.``setuid`(uid)

  设置当前进程的用户ID。

  Availability: Unix.

`os.``strerror`(code)

  根据 code 中的错误码返回错误消息。 在某些平台上当给出未知错误码时 `strerror()` 将返回 `NULL` 并会引发 `ValueError`。

  Availability: Unix, Windows.

`os.``umask`(mask)

  设定当前数值掩码并返回之前的掩码。

  Availability: Unix, Windows.

`os.``uname`()

  Return a 5-tuple containing information identifying the current operating system. The tuple contains 5 strings: `(sysname, nodename, release, version, machine)`. Some systems truncate the nodename to 8 characters or to the leading component; a better way to get the hostname is `socket.gethostname()` or even `socket.gethostbyaddr(socket.gethostname())`.

  Availability: recent flavors of Unix.

`os.``unsetenv`(varname)

  Unset (delete) the environment variable named varname. Such changes to the environment affect subprocesses started with `os.system()`, `popen()` or `fork()` and `execv()`.

  当系统支持 `unsetenv()` ，删除在 `os.environ` 中的变量会自动转换为对 `unsetenv()` 的调用。但是 `unsetenv()` 不能更新 `os.environ`，因此最好直接删除 `os.environ` 中的变量。

  Availability: most flavors of Unix, Windows.

## 15.1.2. 创建文件对象

These functions create new file objects. (See also `open()`.)

`os.``fdopen`(fd[, mode[, bufsize]])

  Return an open file object connected to the file descriptor fd. The mode and bufsize arguments have the same meaning as the corresponding arguments to the built-in `open()` function. If `fdopen()` raises an exception, it leaves fd untouched (unclosed).

  Availability: Unix, Windows.

  在 2.3 版更改: When specified, the mode argument must now start with one of the letters `'r'`, `'w'`, or `'a'`, otherwise a `ValueError` is raised.

  在 2.5 版更改: On Unix, when the mode argument starts with `'a'`, the O_APPEND flag is set on the file descriptor (which the `fdopen()` implementation already does on most platforms).

`os.``popen`(command[, mode[, bufsize]])

  Open a pipe to or from command. The return value is an open file object connected to the pipe, which can be read or written depending on whether mode is `'r'` (default) or `'w'`. The bufsize argument has the same meaning as the corresponding argument to the built-in `open()` function. The exit status of the command (encoded in the format specified for `wait()`) is available as the return value of the `close()` method of the file object, except that when the exit status is zero (termination without errors), `None` is returned.

  Availability: Unix, Windows.

  2.6 版后已移除: This function is obsolete. Use the `subprocess` module. Check especially the Replacing Older Functions with the subprocess Module section.

  在 2.0 版更改: This function worked unreliably under Windows in earlier versions of Python. This was due to the use of the `_popen()` function from the libraries provided with Windows. Newer versions of Python do not use the broken implementation from the Windows libraries.

`os.``tmpfile`()

  Return a new file object opened in update mode (`w+b`). The file has no directory entries associated with it and will be automatically deleted once there are no file descriptors for the file.

  Availability: Unix, Windows.

There are a number of different `popen*()` functions that provide slightly different ways to create subprocesses.

2.6 版后已移除: All of the `popen*()` functions are obsolete. Use the `subprocess` module.

For each of the `popen*()` variants, if bufsize is specified, it specifies the buffer size for the I/O pipes. mode, if provided, should be the string `'b'` or `'t'`; on Windows this is needed to determine whether the file objects should be opened in binary or text mode. The default value for mode is `'t'`.

Also, for each of these variants, on Unix, cmd may be a sequence, in which case arguments will be passed directly to the program without shell intervention (as with `os.spawnv()`). If cmd is a string it will be passed to the shell (as with `os.system()`).

These methods do not make it possible to retrieve the exit status from the child processes. The only way to control the input and output streams and also retrieve the return codes is to use the `subprocess` module; these are only available on Unix.

For a discussion of possible deadlock conditions related to the use of these functions, see Flow Control Issues.

`os.``popen2`(cmd[, mode[, bufsize]])

  Execute cmd as a sub-process and return the file objects `(child_stdin, child_stdout)`.

  2.6 版后已移除: This function is obsolete. Use the `subprocess` module. Check especially the Replacing Older Functions with the subprocess Module section.

  Availability: Unix, Windows.

  2.0 新版功能.

`os.``popen3`(cmd[, mode[, bufsize]])

  Execute cmd as a sub-process and return the file objects `(child_stdin, child_stdout, child_stderr)`.

  2.6 版后已移除: This function is obsolete. Use the `subprocess` module. Check especially the Replacing Older Functions with the subprocess Module section.

  Availability: Unix, Windows.

  2.0 新版功能.

`os.``popen4`(cmd[, mode[, bufsize]])

  Execute cmd as a sub-process and return the file objects `(child_stdin, child_stdout_and_stderr)`.

  2.6 版后已移除: This function is obsolete. Use the `subprocess` module. Check especially the Replacing Older Functions with the subprocess Module section.

  Availability: Unix, Windows.

  2.0 新版功能.

(Note that `child_stdin, child_stdout, and child_stderr` are named from the point of view of the child process, so child_stdin is the child’s standard input.)

This functionality is also available in the `popen2` module using functions of the same names, but the return values of those functions have a different order.

## 15.1.3. 文件描述符操作

这些函数对文件描述符所引用的 I/O 流进行操作。

文件描述符是一些小的整数，对应于当前进程所打开的文件。例如，标准输入的文件描述符通常是0，标准输出是1，标准错误是2。之后被进程打开的文件的文件描述符会被依次指定为3，4，5等。“文件描述符”这个词有点误导性，在 Unix 平台中套接字和管道也被文件描述符所引用。

The `fileno()` method can be used to obtain the file descriptor associated with a file object when required. Note that using the file descriptor directly will bypass the file object methods, ignoring aspects such as internal buffering of data.

`os.``close`(fd)

  关闭文件描述符 fd。

  Availability: Unix, Windows.

  注解

  该功能适用于低级 I/O 操作，必须用于 `os.open()` 或 `pipe()` 返回的文件描述符。关闭由内建函数 `open()` ， `popen()` 或 `fdopen()` 返回的 “文件对象”，则使用其相应的 `close()` 方法。

`os.``closerange`(fd_low, fd_high)

  Close all file descriptors from fd_low (inclusive) to fd_high (exclusive), ignoring errors. Equivalent to:

      for fd in xrange(fd_low, fd_high):
          try:
              os.close(fd)
          except OSError:
              pass

  Availability: Unix, Windows.

  2.6 新版功能.

`os.``dup`(fd)

  Return a duplicate of file descriptor fd.

  Availability: Unix, Windows.

`os.``dup2`(fd, fd2)

  Duplicate file descriptor fd to fd2, closing the latter first if necessary.

  Availability: Unix, Windows.

`os.``fchmod`(fd, mode)

  Change the mode of the file given by fd to the numeric mode. See the docs for `chmod()` for possible values of mode.

  Availability: Unix.

  2.6 新版功能.

`os.``fchown`(fd, uid, gid)

  Change the owner and group id of the file given by fd to the numeric uid and gid. To leave one of the ids unchanged, set it to -1.

  Availability: Unix.

  2.6 新版功能.

`os.``fdatasync`(fd)

  强制将文件描述符 fd 指定文件写入磁盘。不强制更新元数据。

  Availability: Unix.

  注解

  该功能在 MacOS 中不可用。

`os.``fpathconf`(fd, name)

  返回与打开的文件有关的系统配置信息。name 指定要查找的配置名称，它可以是字符串，是一个系统已定义的名称，这些名称定义在不同标准（POSIX.1，Unix 95，Unix 98 等）中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在 `pathconf_names` 字典中给出。对于未包含在该映射中的配置名称，也可以传递一个整数作为 name。

  如果 name 是一个字符串且不是已定义的名称，将抛出 `ValueError` 异常。如果当前系统不支持 name 指定的配置名称，即使该名称存在于 `pathconf_names`，也会抛出 `OSError` 异常，错误码为 `errno.EINVAL`。

  Availability: Unix.

`os.``fstat`(fd)

  Return status for file descriptor fd, like `stat()`.

  Availability: Unix, Windows.

`os.``fstatvfs`(fd)

  Return information about the filesystem containing the file associated with file descriptor fd, like `statvfs()`.

  Availability: Unix.

`os.``fsync`(fd)

  强制将文件描述符 fd 指向的文件写入磁盘。在 Unix，这将调用原生 `fsync()` 函数；在 Windows，则是 MS `_commit()` 函数。

  If you’re starting with a Python file object f, first do `f.flush()`, and then do `os.fsync(f.fileno())`, to ensure that all internal buffers associated with f are written to disk.

  Availability: Unix, and Windows starting in 2.2.3.

`os.``ftruncate`(fd, length)

  Truncate the file corresponding to file descriptor fd, so that it is at most length bytes in size.

  Availability: Unix.

`os.``isatty`(fd)

  如果文件描述符 fd 打开且已连接至 tty 设备（或类 tty 设备），返回 `True`，否则返回 `False`。

`os.``lseek`(fd, pos, how)

  将文件描述符 fd 的当前位置设置为 pos，位置的计算方式 how 如下：设置为 `SEEK_SET` 或 `0` 表示从文件开头计算，设置为 `SEEK_CUR` 或 `1` 表示从文件当前位置计算，设置为 `SEEK_END` 或 `2` 表示文件末尾计算。返回新指针位置，这个位置是从文件开头计算的，单位是字节。

  Availability: Unix, Windows.

`os.``SEEK_SET`
`os.``SEEK_CUR`
`os.``SEEK_END`

  `lseek()` 函数的参数，它们的值分别为 0、1 和 2。

  Availability: Windows, Unix.

  2.5 新版功能.

`os.``open`(file, flags[, mode])

  Open the file file and set various flags according to flags and possibly its mode according to mode. The default mode is `0777` (octal), and the current umask value is first masked out. Return the file descriptor for the newly opened file.

  For a description of the flag and mode values, see the C run-time documentation; flag constants (like `O_RDONLY` and `O_WRONLY`) are defined in this module too (see open() flag constants). In particular, on Windows adding `O_BINARY` is needed to open files in binary mode.

  Availability: Unix, Windows.

  注解

  This function is intended for low-level I/O. For normal usage, use the built-in function `open()`, which returns a “file object” with `read()` and `write()` methods (and many more). To wrap a file descriptor in a “file object”, use `fdopen()`.

`os.``openpty`()

  Open a new pseudo-terminal pair. Return a pair of file descriptors `(master, slave)` for the pty and the tty, respectively. For a (slightly) more portable approach, use the `pty` module.

  Availability: some flavors of Unix.

`os.``pipe`()

  Create a pipe. Return a pair of file descriptors `(r, w)` usable for reading and writing, respectively.

  Availability: Unix, Windows.

`os.``read`(fd, n)

  Read at most n bytes from file descriptor fd. Return a string containing the bytes read. If the end of the file referred to by fd has been reached, an empty string is returned.

  Availability: Unix, Windows.

  注解

  该功能适用于低级 I/O 操作，必须用于 `os.open()` 或 `pipe()` 返回的文件描述符。读取由内建函数 `open()`、`popen()`、`fdopen()` 或 `sys.stdin` 返回的 “文件对象”，则使用其相应的 `read()` 或 `readline()` 方法。

`os.``tcgetpgrp`(fd)

  返回与 fd 给定的终端相关联的进程组（fd 是由 `os.open()` 返回的已打开文件的描述符）。

  Availability: Unix.

`os.``tcsetpgrp`(fd, pg)

  设置与 fd 指定的终端相关联的进程组为 pg*（*fd 是由 `os.open()` 返回的已打开的文件描述符）。

  Availability: Unix.

`os.``ttyname`(fd)

  返回一个字符串，该字符串表示与文件描述符 fd 关联的终端。如果 fd 没有与终端关联，则抛出异常。

  Availability: Unix.

`os.``write`(fd, str)

  Write the string str to file descriptor fd. Return the number of bytes actually written.

  Availability: Unix, Windows.

  注解

  该功能适用于低级 I/O 操作，必须用于 `os.open()` 或 `pipe()` 返回的文件描述符。若要写入由内建函数 `open()`、`popen()`、`fdopen()`、`sys.stdout` 或 `sys.stderr` 返回的 “文件对象”，则应使用其相应的 `write()` 方法。

### 15.1.3.1. `open()` flag constants

The following constants are options for the flags parameter to the `open()` function. They can be combined using the bitwise OR operator `|`. Some of them are not available on all platforms. For descriptions of their availability and use, consult the open(2) manual page on Unix or the MSDN on Windows.

`os.``O_RDONLY`
`os.``O_WRONLY`
`os.``O_RDWR`
`os.``O_APPEND`
`os.``O_CREAT`
`os.``O_EXCL`
`os.``O_TRUNC`

  上述常量在 Unix 和 Windows 上均可用。

`os.``O_DSYNC`
`os.``O_RSYNC`
`os.``O_SYNC`
`os.``O_NDELAY`
`os.``O_NONBLOCK`
`os.``O_NOCTTY`

  这个常数仅在 Unix 系统中可用。

`os.``O_BINARY`
`os.``O_NOINHERIT`
`os.``O_SHORT_LIVED`
`os.``O_TEMPORARY`
`os.``O_RANDOM`
`os.``O_SEQUENTIAL`
`os.``O_TEXT`

  这个常数仅在 Windows 系统中可用。

`os.``O_ASYNC`
`os.``O_DIRECT`
`os.``O_DIRECTORY`
`os.``O_NOFOLLOW`
`os.``O_NOATIME`
`os.``O_SHLOCK`
`os.``O_EXLOCK`

  上述常量是扩展常量，如果 C 库未定义它们，则不存在。

## 15.1.4. 文件和目录

`os.``access`(path, mode)

  使用真实的 uid/gid 测试对 path 的访问。请注意，大多数测试操作将使用有效的 uid/gid，因此可以在 suid/sgid 环境中运用此例程，来测试调用用户是否具有对 path 的指定访问权限。mode 为 `F_OK` 时用于测试 path 是否存在，也可以对 `R_OK`、`W_OK` 和 `X_OK` 中的一个或多个进行“或”运算来测试指定权限。允许访问则返回 `True`，否则返回 `False`。更多信息请参见 Unix 手册页 access(2)。

  Availability: Unix, Windows.

  注解

  使用 `access()` 来检查用户是否具有某项权限（如打开文件的权限），然后再使用 `open()` 打开文件，这样做存在一个安全漏洞，因为用户可能会在检查和打开文件之间的时间里做其他操作。推荐使用 EAFP 技术。如:

      if os.access("myfile", os.R_OK):
          with open("myfile") as fp:
              return fp.read()
      return "some default data"

  最好写成:

      try:
          fp = open("myfile")
      except IOError as e:
          if e.errno == errno.EACCES:
              return "some default data"
          # Not a permission error.
          raise
      else:
          with fp:
              return fp.read()

  注解

  即使 `access()` 指示 I/O 操作会成功，但实际操作仍可能失败，尤其是对网络文件系统的操作，其权限语义可能超出常规的 POSIX 权限位模型。

`os.``F_OK`

  Value to pass as the mode parameter of `access()` to test the existence of path.

`os.``R_OK`

  Value to include in the mode parameter of `access()` to test the readability of path.

`os.``W_OK`

  Value to include in the mode parameter of `access()` to test the writability of path.

`os.``X_OK`

  Value to include in the mode parameter of `access()` to determine if path can be executed.

`os.``chdir`(path)

  将当前工作目录更改为 path。

  Availability: Unix, Windows.

`os.``fchdir`(fd)

  Change the current working directory to the directory represented by the file descriptor fd. The descriptor must refer to an opened directory, not an open file.

  Availability: Unix.

  2.3 新版功能.

`os.``getcwd`()

  返回表示当前工作目录的字符串。

  Availability: Unix, Windows.

`os.``getcwdu`()

  Return a Unicode object representing the current working directory.

  Availability: Unix, Windows.

  2.3 新版功能.

`os.``chflags`(path, flags)

  将 path 标志设置为数字 标志。标志 可以用以下值按位或组合起来（以下值在 `stat` 模块中定义）：

  - `stat.UF_NODUMP`

  - `stat.UF_IMMUTABLE`

  - `stat.UF_APPEND`

  - `stat.UF_OPAQUE`

  - `stat.UF_NOUNLINK`

  - `stat.UF_COMPRESSED`

  - `stat.UF_HIDDEN`

  - `stat.SF_ARCHIVED`

  - `stat.SF_IMMUTABLE`

  - `stat.SF_APPEND`

  - `stat.SF_NOUNLINK`

  - `stat.SF_SNAPSHOT`

  Availability: Unix.

  2.6 新版功能.

`os.``chroot`(path)

  Change the root directory of the current process to path. Availability: Unix.

  2.2 新版功能.

`os.``chmod`(path, mode)

  将 path 的 mode 更改为其他由数字表示的 mode。mode 可以用以下值之一，也可以将它们按位或组合起来（以下值在 `stat` 模块中定义）：

  - `stat.S_ISUID`

  - `stat.S_ISGID`

  - `stat.S_ENFMT`

  - `stat.S_ISVTX`

  - `stat.S_IREAD`

  - `stat.S_IWRITE`

  - `stat.S_IEXEC`

  - `stat.S_IRWXU`

  - `stat.S_IRUSR`

  - `stat.S_IWUSR`

  - `stat.S_IXUSR`

  - `stat.S_IRWXG`

  - `stat.S_IRGRP`

  - `stat.S_IWGRP`

  - `stat.S_IXGRP`

  - `stat.S_IRWXO`

  - `stat.S_IROTH`

  - `stat.S_IWOTH`

  - `stat.S_IXOTH`

  Availability: Unix, Windows.

  注解

  Although Windows supports `chmod()`, you can only set the file’s read-only flag with it (via the `stat.S_IWRITE` and `stat.S_IREAD` constants or a corresponding integer value). All other bits are ignored.

`os.``chown`(path, uid, gid)

  Change the owner and group id of path to the numeric uid and gid. To leave one of the ids unchanged, set it to -1.

  Availability: Unix.

`os.``lchflags`(path, flags)

  Set the flags of path to the numeric flags, like `chflags()`, but do not follow symbolic links.

  Availability: Unix.

  2.6 新版功能.

`os.``lchmod`(path, mode)

  Change the mode of path to the numeric mode. If path is a symlink, this affects the symlink rather than the target. See the docs for `chmod()` for possible values of mode.

  Availability: Unix.

  2.6 新版功能.

`os.``lchown`(path, uid, gid)

  Change the owner and group id of path to the numeric uid and gid. This function will not follow symbolic links.

  Availability: Unix.

  2.3 新版功能.

`os.``link`(source, link_name)

  Create a hard link pointing to source named link_name.

  Availability: Unix.

`os.``listdir`(path)

  Return a list containing the names of the entries in the directory given by path. The list is in arbitrary order. It does not include the special entries `'.'` and `'..'` even if they are present in the directory.

  Availability: Unix, Windows.

  在 2.3 版更改: On Windows NT/2k/XP and Unix, if path is a Unicode object, the result will be a list of Unicode objects. Undecodable filenames will still be returned as string objects.

`os.``lstat`(path)

  Perform the equivalent of an `lstat()` system call on the given path. Similar to `stat()`, but does not follow symbolic links. On platforms that do not support symbolic links, this is an alias for `stat()`.

`os.``mkfifo`(path[, mode])

  Create a FIFO (a named pipe) named path with numeric mode mode. The default mode is `0666` (octal). The current umask value is first masked out from the mode.

  Availability: Unix.

  FIFO 是可以像常规文件一样访问的管道。FIFO 如果没有被删除（如使用 `os.unlink()`），会一直存在。通常，FIFO 用作“客户端”和“服务器”进程之间的汇合点：服务器打开 FIFO 进行读取，而客户端打开 FIFO 进行写入。请注意，`mkfifo()` 不会打开 FIFO — 它只是创建汇合点。

`os.``mknod`(filename[, mode=0600[, device=0]])

  Create a filesystem node (file, device special file or named pipe) named filename. mode specifies both the permissions to use and the type of node to be created, being combined (bitwise OR) with one of `stat.S_IFREG`, `stat.S_IFCHR`, `stat.S_IFBLK`, and `stat.S_IFIFO` (those constants are available in `stat`). For `stat.S_IFCHR` and `stat.S_IFBLK`, device defines the newly created device special file (probably using `os.makedev()`), otherwise it is ignored.

  2.3 新版功能.

`os.``major`(device)

  提取主设备号，提取自原始设备号（通常是 `stat` 中的 `st_dev` 或 `st_rdev` 字段）。

  2.3 新版功能.

`os.``minor`(device)

  提取次设备号，提取自原始设备号（通常是 `stat` 中的 `st_dev` 或 `st_rdev` 字段）。

  2.3 新版功能.

`os.``makedev`(major, minor)

  将主设备号和次设备号组合成原始设备号。

  2.3 新版功能.

`os.``mkdir`(path[, mode])

  Create a directory named path with numeric mode mode. The default mode is `0777` (octal). If the directory already exists, `OSError` is raised.

  某些系统会忽略 mode。如果没有忽略它，那么将首先从它中减去当前的 umask 值。如果除最后 9 位（即 mode 八进制的最后 3 位）之外，还设置了其他位，则其他位的含义取决于各个平台。在某些平台上，它们会被忽略，应显式调用 `chmod()` 进行设置。

  如果需要创建临时目录，请参阅 `tempfile` 模块中的 `tempfile.mkdtemp()` 函数。

  Availability: Unix, Windows.

`os.``makedirs`(path[, mode])

  Recursive directory creation function. Like `mkdir()`, but makes all intermediate-level directories needed to contain the leaf directory. Raises an `error` exception if the leaf directory already exists or cannot be created. The default mode is `0777` (octal).

  The mode parameter is passed to `mkdir()`; see the mkdir() description for how it is interpreted.

  注解

  `makedirs()` will become confused if the path elements to create include `os.pardir`.

  1.5.2 新版功能.

  在 2.3 版更改: This function now handles UNC paths correctly.

`os.``pathconf`(path, name)

  返回所给名称的文件有关的系统配置信息。name 指定要查找的配置名称，它可以是字符串，是一个系统已定义的名称，这些名称定义在不同标准（POSIX.1，Unix 95，Unix 98 等）中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在 `pathconf_names` 字典中给出。对于未包含在该映射中的配置名称，也可以传递一个整数作为 name。

  如果 name 是一个字符串且不是已定义的名称，将抛出 `ValueError` 异常。如果当前系统不支持 name 指定的配置名称，即使该名称存在于 `pathconf_names`，也会抛出 `OSError` 异常，错误码为 `errno.EINVAL`。

  Availability: Unix.

`os.``pathconf_names`

  Dictionary mapping names accepted by `pathconf()` and `fpathconf()` to the integer values defined for those names by the host operating system. This can be used to determine the set of names known to the system. Availability: Unix.

`os.``readlink`(path)

  返回一个字符串，为符号链接指向的实际路径。其结果可以是绝对或相对路径。如果是相对路径，则可用 `os.path.join(os.path.dirname(path), result)` 转换为绝对路径。

  在 2.6 版更改: If the path is a Unicode object the result will also be a Unicode object.

  Availability: Unix.

`os.``remove`(path)

  Remove (delete) the file path. If path is a directory, `OSError` is raised; see `rmdir()` below to remove a directory. This is identical to the `unlink()` function documented below. On Windows, attempting to remove a file that is in use causes an exception to be raised; on Unix, the directory entry is removed but the storage allocated to the file is not made available until the original file is no longer in use.

  Availability: Unix, Windows.

`os.``removedirs`(path)

  递归删除目录。工作方式类似于 `rmdir()`，不同之处在于，如果成功删除了末尾一级目录，`removedirs()` 会尝试依次删除 path 中提到的每个父目录，直到抛出错误为止（但该错误会被忽略，因为这通常表示父目录不是空目录）。例如，`os.removedirs('foo/bar/baz')` 将首先删除目录 `'foo/bar/baz'`，然后如果 `'foo/bar'` 和 `'foo'` 为空，则继续删除它们。如果无法成功删除末尾一级目录，则抛出 `OSError` 异常。

  1.5.2 新版功能.

`os.``rename`(src, dst)

  Rename the file or directory src to dst. If dst is a directory, `OSError` will be raised. On Unix, if dst exists and is a file, it will be replaced silently if the user has permission. The operation may fail on some Unix flavors if src and dst are on different filesystems. If successful, the renaming will be an atomic operation (this is a POSIX requirement). On Windows, if dst already exists, `OSError` will be raised even if it is a file; there may be no way to implement an atomic rename when dst names an existing file.

  Availability: Unix, Windows.

`os.``renames`(old, new)

  递归重命名目录或文件。工作方式类似 `rename()`，除了会首先创建新路径所需的中间目录。重命名后，将调用 `removedirs()` 删除旧路径中不需要的目录。

  1.5.2 新版功能.

  注解

  如果用户没有权限删除末级的目录或文件，则本函数可能会无法建立新的目录结构。

`os.``rmdir`(path)

  Remove (delete) the directory path. Only works when the directory is empty, otherwise, `OSError` is raised. In order to remove whole directory trees, `shutil.rmtree()` can be used.

  Availability: Unix, Windows.

`os.``stat`(path)

  Perform the equivalent of a `stat()` system call on the given path. (This function follows symlinks; to stat a symlink use `lstat()`.)

  The return value is an object whose attributes correspond to the members of the `stat` structure, namely:

  - `st_mode` - protection bits,

  - `st_ino` - inode number,

  - `st_dev` - device,

  - `st_nlink` - number of hard links,

  - `st_uid` - user id of owner,

  - `st_gid` - group id of owner,

  - `st_size` - size of file, in bytes,

  - `st_atime` - time of most recent access,

  - `st_mtime` - time of most recent content modification,

  - `st_ctime` - platform dependent; time of most recent metadata change on Unix, or the time of creation on Windows)

  在 2.3 版更改: If `stat_float_times()` returns `True`, the time values are floats, measuring seconds. Fractions of a second may be reported if the system supports that. See `stat_float_times()` for further discussion.

  在某些 Unix 系统上（如 Linux 上），以下属性可能也可用：

  - `st_blocks` - number of 512-byte blocks allocated for file

  - `st_blksize` - filesystem blocksize for efficient file system I/O

  - `st_rdev` - type of device if an inode device

  - `st_flags` - user defined flags for file

  在其他 Unix 系统上（如 FreeBSD 上），以下属性可能可用（但仅当 root 使用它们时才被填充）：

  - `st_gen` - file generation number

  - `st_birthtime` - time of file creation

  On RISCOS systems, the following attributes are also available:

  - `st_ftype` (file type)

  - `st_attrs` (attributes)

  - `st_obtype` (object type).

  注解

  `st_atime`、`st_mtime` 和 `st_ctime` 属性的确切含义和分辨率取决于操作系统和文件系统。例如，在使用 FAT 或 FAT32 文件系统的 Windows 上，`st_mtime` 有 2 秒的分辨率，而 `st_atime` 仅有 1 天的分辨率。详细信息请参阅操作系统文档。

  For backward compatibility, the return value of `stat()` is also accessible as a tuple of at least 10 integers giving the most important (and portable) members of the `stat` structure, in the order `st_mode`, `st_ino`, `st_dev`, `st_nlink`, `st_uid`, `st_gid`, `st_size`, `st_atime`, `st_mtime`, `st_ctime`. More items may be added at the end by some implementations.

  标准模块 `stat` 中定义了函数和常量，这些函数和常量可用于从 `stat` 结构体中提取信息。（在 Windows 上，某些项填充的是虚值。）

  示例:

      >>> import os
      >>> statinfo = os.stat('somefile.txt')
      >>> statinfo
      (33188, 422511, 769, 1, 1032, 100, 926, 1105022698,1105022732, 1105022732)
      >>> statinfo.st_size
      926

  Availability: Unix, Windows.

  在 2.2 版更改: Added access to values as attributes of the returned object.

  在 2.5 版更改: Added `st_gen` and `st_birthtime`.

`os.``stat_float_times`([newvalue])

  Determine whether `stat_result` represents time stamps as float objects. If newvalue is `True`, future calls to `stat()` return floats, if it is `False`, future calls return ints. If newvalue is omitted, return the current setting.

  For compatibility with older Python versions, accessing `stat_result` as a tuple always returns integers.

  在 2.5 版更改: Python now returns float values by default. Applications which do not work correctly with floating point time stamps can use this function to restore the old behaviour.

  The resolution of the timestamps (that is the smallest possible fraction) depends on the system. Some systems only support second resolution; on these systems, the fraction will always be zero.

  It is recommended that this setting is only changed at program startup time in the __main__ module; libraries should never change this setting. If an application uses a library that works incorrectly if floating point time stamps are processed, this application should turn the feature off until the library has been corrected.

`os.``statvfs`(path)

  Perform a `statvfs()` system call on the given path. The return value is an object whose attributes describe the filesystem on the given path, and correspond to the members of the `statvfs` structure, namely: `f_bsize`, `f_frsize`, `f_blocks`, `f_bfree`, `f_bavail`, `f_files`, `f_ffree`, `f_favail`, `f_flag`, `f_namemax`.

  For backward compatibility, the return value is also accessible as a tuple whose values correspond to the attributes, in the order given above. The standard module `statvfs` defines constants that are useful for extracting information from a `statvfs` structure when accessing it as a sequence; this remains useful when writing code that needs to work with versions of Python that don’t support accessing the fields as attributes.

  Availability: Unix.

  在 2.2 版更改: Added access to values as attributes of the returned object.

`os.``symlink`(source, link_name)

  Create a symbolic link pointing to source named link_name.

  Availability: Unix.

`os.``tempnam`([dir[, prefix]])

  Return a unique path name that is reasonable for creating a temporary file. This will be an absolute path that names a potential directory entry in the directory dir or a common location for temporary files if dir is omitted or `None`. If given and not `None`, prefix is used to provide a short prefix to the filename. Applications are responsible for properly creating and managing files created using paths returned by `tempnam()`; no automatic cleanup is provided. On Unix, the environment variable `TMPDIR` overrides dir, while on Windows `TMP` is used. The specific behavior of this function depends on the C library implementation; some aspects are underspecified in system documentation.

  警告

  Use of `tempnam()` is vulnerable to symlink attacks; consider using `tmpfile()` (section 创建文件对象) instead.

  Availability: Unix, Windows.

`os.``tmpnam`()

  Return a unique path name that is reasonable for creating a temporary file. This will be an absolute path that names a potential directory entry in a common location for temporary files. Applications are responsible for properly creating and managing files created using paths returned by `tmpnam()`; no automatic cleanup is provided.

  警告

  Use of `tmpnam()` is vulnerable to symlink attacks; consider using `tmpfile()` (section 创建文件对象) instead.

  Availability: Unix, Windows. This function probably shouldn’t be used on Windows, though: Microsoft’s implementation of `tmpnam()` always creates a name in the root directory of the current drive, and that’s generally a poor location for a temp file (depending on privileges, you may not even be able to open a file using this name).

`os.``TMP_MAX`

  The maximum number of unique names that `tmpnam()` will generate before reusing names.

`os.``unlink`(path)

  Remove (delete) the file path. This is the same function as `remove()`; the `unlink()` name is its traditional Unix name.

  Availability: Unix, Windows.

`os.``utime`(path, times)

  Set the access and modified times of the file specified by path. If times is `None`, then the file’s access and modified times are set to the current time. (The effect is similar to running the Unix program touch on the path.) Otherwise, times must be a 2-tuple of numbers, of the form `(atime, mtime)` which is used to set the access and modified times, respectively. Whether a directory can be given for path depends on whether the operating system implements directories as files (for example, Windows does not). Note that the exact times you set here may not be returned by a subsequent `stat()` call, depending on the resolution with which your operating system records access and modification times; see `stat()`.

  在 2.0 版更改: Added support for `None` for times.

  Availability: Unix, Windows.

`os.``walk`(top, topdown=True, onerror=None, followlinks=False)

  生成目录树中的文件名，方式是按上->下或下->上顺序浏览目录树。对于以 top 为根的目录树中的每个目录（包括 top 本身），它都会生成一个三元组 `(dirpath, dirnames, filenames)`。

  dirpath 是一个字符串，表示目录的路径。dirnames 是一个列表，内含 dirpath 中子目录的名称（不包括 `'.'` 和 `'..'` ）。filenames 也是列表，内含 dirpath 中非目录文件的名称。注意，列表中的名称不包含路径部分。要获取 dirpath 中文件或目录的完整路径（从 top 起始），请执行 `os.path.join(dirpath, name)`。

  如果可选参数 topdown 为 `True` 或未指定，则在所有子目录的三元组之前生成父目录的三元组（目录是自上而下生成的）。如果 topdown 为 `False`，则在所有子目录的三元组生成之后再生成父目录的三元组（目录是自下而上生成的）。无论 topdown 为何值，在生成目录及其子目录的元组之前，都将检索全部子目录列表。

  当 topdown 为 `True` 时，调用者可以就地修改 dirnames 列表（也许用到了 `del` 或切片），而 `walk()` 将仅仅递归到仍保留在 dirnames 中的子目录内。这可用于减少搜索、加入特定的访问顺序，甚至可在继续 `walk()` 之前告知 `walk()` 由调用者新建或重命名的目录的信息。当 topdown 为 `False` 时，修改 dirnames 对 walk 的行为没有影响，因为在自下而上模式中，dirnames 中的目录是在 dirpath 本身之前生成的。

  By default, errors from the `listdir()` call are ignored. If optional argument onerror is specified, it should be a function; it will be called with one argument, an `OSError` instance. It can report the error to continue with the walk, or raise the exception to abort the walk. Note that the filename is available as the `filename` attribute of the exception object.

  `walk()` 默认不会递归进指向目录的符号链接。可以在支持符号链接的系统上将 followlinks 设置为 `True`，以访问符号链接指向的目录。

  2.6 新版功能: The followlinks parameter.

  注解

  注意，如果链接指向自身的父目录，则将 followlinks 设置为 `True` 可能导致无限递归。`walk()` 不会记录它已经访问过的目录。

  注解

  如果传入的是相对路径，请不要在恢复 `walk()` 之间更改当前工作目录。`walk()` 不会更改当前目录，并假定其调用者也不会更改当前目录。

  下面的示例遍历起始目录内所有子目录，打印每个目录内的文件占用的字节数，CVS 子目录不会被遍历:

      import os
      from os.path import join, getsize
      for root, dirs, files in os.walk('python/Lib/email'):
          print root, "consumes",
          print sum(getsize(join(root, name)) for name in files),
          print "bytes in", len(files), "non-directory files"
          if 'CVS' in dirs:
              dirs.remove('CVS')  # don't visit CVS directories

  在下一个示例中，必须使树自下而上遍历，因为 `rmdir()` 只允许在目录为空时删除目录:

      # Delete everything reachable from the directory named in "top",
      # assuming there are no symbolic links.
      # CAUTION:  This is dangerous!  For example, if top == '/', it
      # could delete all your disk files.
      import os
      for root, dirs, files in os.walk(top, topdown=False):
          for name in files:
              os.remove(os.path.join(root, name))
          for name in dirs:
              os.rmdir(os.path.join(root, name))

  2.3 新版功能.

## 15.1.5. 进程管理

下列函数可用于创建和管理进程。

所有 `exec*` 函数都接受一个参数列表，用来给新程序加载到它的进程中。在所有情况下，传递给新程序的第一个参数是程序本身的名称，而不是用户在命令行上输入的参数。对于 C 程序员来说，这就是传递给 `main()` 函数的 `argv[0]`。例如，`os.execv('/bin/echo', ['foo', 'bar'])` 只会在标准输出上打印 `bar`，而 `foo` 会被忽略。

`os.``abort`()

  发送 `SIGABRT` 信号到当前进程。在 Unix 上，默认行为是生成一个核心转储。在 Windows 上，该进程立即返回退出代码 `3`。请注意，使用 `signal.signal()` 可以为 `SIGABRT` 注册 Python 信号处理程序，而调用本函数将不会调用按前述方法注册的程序。

  Availability: Unix, Windows.

`os.``execl`(path, arg0, arg1, ...)
`os.``execle`(path, arg0, arg1, ..., env)
`os.``execlp`(file, arg0, arg1, ...)
`os.``execlpe`(file, arg0, arg1, ..., env)
`os.``execv`(path, args)
`os.``execve`(path, args, env)
`os.``execvp`(file, args)
`os.``execvpe`(file, args, env)

  这些函数都将执行一个新程序，以替换当前进程。它们没有返回值。在 Unix 上，新程序会加载到当前进程中，且进程号与调用者相同。过程中的错误会被报告为 `OSError` 异常。

  当前进程会被立即替换。打开的文件对象和描述符都不会刷新，因此如果这些文件上可能缓冲了数据，则应在调用 `exec*` 函数之前使用 `sys.stdout.flush()` 或 `os.fsync()` 刷新它们。

  `exec*` 函数的 “l” 和 “v” 变体不同在于命令行参数的传递方式。如果在编码时固定了参数数量，则 “l” 变体可能是最方便的，各参数作为 `execl*()` 函数的附加参数传入即可。当参数数量可变时，”v” 变体更方便，参数以列表或元组的形式作为 args 参数传递。在这两种情况下，子进程的第一个参数都应该是即将运行的命令名称，但这不是强制性的。

  结尾包含 “p” 的变体（`execlp()`、`execlpe()`、`execvp()` 和 `execvpe()` ）将使用 `PATH` 环境变量来查找程序 file。当环境被替换时（使用下一段讨论的 `exec*e` 变体之一），`PATH` 变量将来自于新环境。其他变体 `execl()`、`execle()`、`execv()` 和 `execve()` 不使用 `PATH` 变量来查找程序，因此 path 必须包含正确的绝对或相对路径。

  对于 `execle()`、`execlpe()`、`execve()` 和 `execvpe()` （都以 “e” 结尾），env 参数是一个映射，用于定义新进程的环境变量（代替当前进程的环境变量）。而函数 `execl()`、`execlp()`、`execv()` 和 `execvp()` 会将当前进程的环境变量过继给新进程。

  Availability: Unix, Windows.

`os.``_exit`(n)

  以状态码 n 退出进程，不会调用清理处理程序，不会刷新 stdio，等等。

  Availability: Unix, Windows.

  注解

  退出的标准方法是使用 `sys.exit(n)`。而 `_exit()` 通常只应在 `fork()` 出的子进程中使用。

以下是已定义的退出代码，可以用于 `_exit()`，尽管它们不是必需的。这些退出代码通常用于 Python 编写的系统程序，例如邮件服务器的外部命令传递程序。

注解

其中部分退出代码在部分 Unix 平台上可能不可用，因为平台间存在差异。如果底层平台定义了这些常量，那上层也会定义。

`os.``EX_OK`

  退出代码，表示未发生任何错误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_USAGE`

  退出代码，表示命令使用不正确，如给出的参数数量有误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_DATAERR`

  退出代码，表示输入数据不正确。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_NOINPUT`

  退出代码，表示某个输入文件不存在或不可读。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_NOUSER`

  退出代码，表示指定的用户不存在。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_NOHOST`

  退出代码，表示指定的主机不存在。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_UNAVAILABLE`

  退出代码，表示所需的服务不可用。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_SOFTWARE`

  退出代码，表示检测到内部软件错误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_OSERR`

  退出代码，表示检测到操作系统错误，例如无法 fork 或创建管道。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_OSFILE`

  退出代码，意味着某些系统文件不存在，无法打开或发生其他错误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_CANTCREAT`

  退出代码，表示无法创建用户指定的输出文件。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_IOERR`

  退出代码，表示对某些文件进行读写时发生错误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_TEMPFAIL`

  退出代码，表示发生了暂时性故障。它可能并非意味着真正的错误，例如在可重试的情况下无法建立网络连接。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_PROTOCOL`

  退出代码，表示协议交换是非法的、无效的或无法解读的。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_NOPERM`

  退出代码，表示没有足够的权限执行该操作（但不适用于文件系统问题）。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_CONFIG`

  退出代码，表示发生某种配置错误。

  Availability: Unix.

  2.3 新版功能.

`os.``EX_NOTFOUND`

  退出代码，表示的内容类似于“找不到条目”。

  Availability: Unix.

  2.3 新版功能.

`os.``fork`()

  Fork 出一个子进程。在子进程中返回 `0`，在父进程中返回子进程的进程号。如果发生错误，则抛出 `OSError` 异常。

  Note that some platforms including FreeBSD <= 6.3, Cygwin and OS/2 EMX have known issues when using fork() from a thread.

  警告

  有关 SSL 模块与 fork() 结合的应用，请参阅 `ssl`。

  Availability: Unix.

`os.``forkpty`()

  Fork 出一个子进程，使用新的伪终端作为子进程的控制终端。返回一对 `(pid, fd)`，其中 pid 在子进程中为 `0`，这是父进程中新子进程的进程号，而 fd 是伪终端主设备的文件描述符。对于更便于移植的方法，请使用 `pty` 模块。如果发生错误，则抛出 `OSError` 异常。

  Availability: some flavors of Unix.

`os.``kill`(pid, sig)

  将信号 sig 发送至进程 pid。特定平台上可用的信号常量定义在 `signal` 模块中。

  Windows： `signal.CTRL_C_EVENT` 和 `signal.CTRL_BREAK_EVENT` 信号是特殊信号，只能发送给共享同一个控制台窗口的控制台进程，如某些子进程。sig 取任何其他值将导致该进程被 TerminateProcess API 无条件终止，且退出代码为 sig。Windows 版本的 `kill()` 还需要传入待结束进程的句柄。

  2.7 新版功能: Windows support

`os.``killpg`(pgid, sig)

  将信号 sig 发送给进程组 pgid。

  Availability: Unix.

  2.3 新版功能.

`os.``nice`(increment)

  将进程的优先级（nice 值）增加 increment，返回新的 nice 值。

  Availability: Unix.

`os.``plock`(op)

  将程序段锁定到内存中。op 的值（定义在 `<sys/lock.h>` 中）决定了哪些段被锁定。

  Availability: Unix.

`os.``popen`(...)
`os.``popen2`(...)
`os.``popen3`(...)
`os.``popen4`(...)

  Run child processes, returning opened pipes for communications. These functions are described in section 创建文件对象.

`os.``spawnl`(mode, path, ...)
`os.``spawnle`(mode, path, ..., env)
`os.``spawnlp`(mode, file, ...)
`os.``spawnlpe`(mode, file, ..., env)
`os.``spawnv`(mode, path, args)
`os.``spawnve`(mode, path, args, env)
`os.``spawnvp`(mode, file, args)
`os.``spawnvpe`(mode, file, args, env)

  在新进程中执行程序 path。

  （注意，`subprocess` 模块提供了更强大的工具来生成新进程并跟踪执行结果，使用该模块比使用这些函数更好。尤其应当检查 Replacing Older Functions with the subprocess Module 部分。）

  mode 为 `P_NOWAIT` 时，本函数返回新进程的进程号。mode 为 `P_WAIT` 时，如果进程正常退出，返回退出代码，如果被杀死，返回 `-signal`，其中 signal 是杀死进程的信号。在 Windows 上，进程号实际上是进程句柄，因此可以与 `waitpid()` 函数一起使用。

  `spawn*` 函数的 “l” 和 “v” 变体不同在于命令行参数的传递方式。如果在编码时固定了参数数量，则 “l” 变体可能是最方便的，各参数作为 `spawnl*()` 函数的附加参数传入即可。当参数数量可变时，”v” 变体更方便，参数以列表或元组的形式作为 args 参数传递。在这两种情况下，子进程的第一个参数都必须是即将运行的命令名称。

  结尾包含第二个 “p” 的变体（`spawnlp()`、`spawnlpe()`、`spawnvp()` 和 `spawnvpe()`）将使用 `PATH` 环境变量来查找程序 file。当环境被替换时（使用下一段讨论的 `spawn*e` 变体之一），`PATH` 变量将来自于新环境。其他变体 `spawnl()`、`spawnle()`、`spawnv()` 和 `spawnve()` 不使用 `PATH` 变量来查找程序，因此 path 必须包含正确的绝对或相对路径。

  对于 `spawnle()`、`spawnlpe()`、`spawnve()` 和 `spawnvpe()` （都以 “e” 结尾），env 参数是一个映射，用于定义新进程的环境变量（代替当前进程的环境变量）。而函数 `spawnl()`、`spawnlp()`、`spawnv()` 和 `spawnvp()` 会将当前进程的环境变量过继给新进程。注意，env 字典中的键和值必须是字符串。无效的键或值将导致函数出错，返回值为 `127`。

  例如，以下对 `spawnlp()` 和 `spawnvpe()` 的调用是等效的:

      import os
      os.spawnlp(os.P_WAIT, 'cp', 'cp', 'index.html', '/dev/null')

      L = ['cp', 'index.html', '/dev/null']
      os.spawnvpe(os.P_WAIT, 'cp', L, os.environ)

  Availability: Unix, Windows. `spawnlp()`, `spawnlpe()`, `spawnvp()` and `spawnvpe()` are not available on Windows. `spawnle()` and `spawnve()` are not thread-safe on Windows; we advise you to use the `subprocess` module instead.

  1.6 新版功能.

`os.``P_NOWAIT`
`os.``P_NOWAITO`

  `spawn*` 系列函数的 mode 参数的可取值。如果给出这些值中的任何一个，则 `spawn*()` 函数将在创建新进程后立即返回，且返回值为进程号。

  Availability: Unix, Windows.

  1.6 新版功能.

`os.``P_WAIT`

  `spawn*` 系列函数的 mode 参数的可取值。如果将 mode 指定为该值，则 `spawn*()` 函数将在新进程运行完毕后返回，运行成功则返回进程的退出代码，被信号终止则返回 `-signal`。

  Availability: Unix, Windows.

  1.6 新版功能.

`os.``P_DETACH`
`os.``P_OVERLAY`

  Possible values for the mode parameter to the `spawn*` family of functions. These are less portable than those listed above. `P_DETACH` is similar to `P_NOWAIT`, but the new process is detached from the console of the calling process. If `P_OVERLAY` is used, the current process will be replaced; the `spawn*()` function will not return.

  Availability: Windows.

  1.6 新版功能.

`os.``startfile`(path[, operation])

  使用已关联的应用程序打开文件。

  当 operation 未指定或指定为 `'open'` 时，这类似于在 Windows 资源管理器中双击文件，或在交互式命令行中将文件名作为 start 命令的参数：通过扩展名相关联的应用程序（如果有）打开文件。

  当指定另一个 operation 时，它必须是一个“命令动词” (“command verb”)，该词指定对文件执行的操作。Microsoft 文档中的常用动词有 `'print'` 和 `'edit'` （用于文件），以及 `'explore'` 和 `'find'` （用于目录）。

  关联的应用程序启动后 `startfile()` 就会立即返回。本函数没有等待应用程序关闭的选项，也没有办法检索应用程序的退出状态。path 参数是基于当前目录的相对路径。如果要使用绝对路径，请确保第一个字符不是斜杠 (`'/'`)，是斜杠的话底层的 Win32 `ShellExecute()` 函数将失效。使用 `os.path.normpath()` 函数确保路径已针对 Win32 正确编码。

  Availability: Windows.

  2.0 新版功能.

  2.5 新版功能: The operation parameter.

`os.``system`(command)

  Execute the command (a string) in a subshell. This is implemented by calling the Standard C function `system()`, and has the same limitations. Changes to `sys.stdin`, etc. are not reflected in the environment of the executed command.

  在 Unix 上，返回值是进程的退出状态，编码格式与为 `wait()` 指定的格式相同。注意，POSIX 没有指定 C 函数 `system()` 返回值的含义，因此 Python 函数的返回值与系统有关。

  On Windows, the return value is that returned by the system shell after running command, given by the Windows environment variable `COMSPEC`: on command.com systems (Windows 95, 98 and ME) this is always `0`; on cmd.exe systems (Windows NT, 2000 and XP) this is the exit status of the command run; on systems using a non-native shell, consult your shell documentation.

  `subprocess` 模块提供了更强大的工具来生成新进程并跟踪执行结果，使用该模块比使用本函数更好。参阅 `subprocess` 文档中的 Replacing Older Functions with the subprocess Module 部分以获取有用的帮助。

  Availability: Unix, Windows.

`os.``times`()

  Return a 5-tuple of floating point numbers indicating accumulated (processor or other) times, in seconds. The items are: user time, system time, children’s user time, children’s system time, and elapsed real time since a fixed point in the past, in that order. See the Unix manual page times(2) or the corresponding Windows Platform API documentation. On Windows, only the first two items are filled, the others are zero.

  Availability: Unix, Windows

`os.``wait`()

  等待子进程执行完毕，返回一个元组，包含其 pid 和退出状态指示：一个 16 位数字，其低字节是终止该进程的信号编号，高字节是退出状态码（信号编号为零的情况下），如果生成了核心文件，则低字节的高位会置位。

  Availability: Unix.

`os.``waitpid`(pid, options)

  本函数的细节在 Unix 和 Windows 上有不同之处。

  在 Unix 上：等待进程号为 pid 的子进程执行完毕，返回一个元组，内含其进程 ID 和退出状态指示（编码与 `wait()` 相同）。调用的语义受整数 options 的影响，常规操作下该值应为 `0`。

  如果 pid 大于 `0`，则 `waitpid()` 会获取该指定进程的状态信息。如果 pid 为 `0`，则获取当前进程所在进程组中的所有子进程的状态。如果 pid 为 `-1`，则获取当前进程的子进程状态。如果 pid 小于 `-1`，则获取进程组 `-pid` （ pid 的绝对值）中所有进程的状态。

  当系统调用返回 -1 时，将抛出带有错误码的 `OSError` 异常。

  在 Windows 上：等待句柄为 pid 的进程执行完毕，返回一个元组，内含 pid 以及左移 8 位后的退出状态（移位简化了跨平台使用本函数）。小于或等于 `0` 的 pid 在 Windows 上没有特殊含义，且会抛出异常。整数值 options 无效。pid 可以指向任何 ID 已知的进程，不一定是子进程。调用 `spawn*` 函数时传入 `P_NOWAIT` 将返回合适的进程句柄。

`os.``wait3`(options)

  与 `waitpid()` 相似，差别在于没有进程 ID 参数，且返回一个 3 元组，其中包括子进程 ID，退出状态指示和资源使用信息。关于资源使用信息的详情，请参考 `resource`.`getrusage()`。option 参数与传入 `waitpid()` 和 `wait4()` 的相同。

  Availability: Unix.

  2.5 新版功能.

`os.``wait4`(pid, options)

  与 `waitpid()` 相似，差别在本方法返回一个 3 元组，其中包括子进程 ID，退出状态指示和资源使用信息。关于资源使用信息的详情，请参考 `resource`.`getrusage()`。`wait4()` 的参数与 `waitpid()` 的参数相同。

  Availability: Unix.

  2.5 新版功能.

`os.``WNOHANG`

  用于 `waitpid()` 的选项，如果没有立即可用的子进程状态，则立即返回。在这种情况下，函数返回 `(0, 0)`。

  Availability: Unix.

`os.``WCONTINUED`

  被作业控制停止的子进程，如果自上次报告状态以来，已继续进行，则此选项将报告这些子进程。

  Availability: Some Unix systems.

  2.3 新版功能.

`os.``WUNTRACED`

  已停止的子进程，如果自停止以来尚未报告其当前状态，则此选项将报告这些子进程。

  Availability: Unix.

  2.3 新版功能.

下列函数采用进程状态码作为参数，状态码由 `system()`、`wait()` 或 `waitpid()` 返回。它们可用于确定进程上发生的操作。

`os.``WCOREDUMP`(status)

  如果为该进程生成了核心转储，返回 `True`，否则返回 `False`。

  Availability: Unix.

  2.3 新版功能.

`os.``WIFCONTINUED`(status)

  Return `True` if the process has been continued from a job control stop, otherwise return `False`.

  Availability: Unix.

  2.3 新版功能.

`os.``WIFSTOPPED`(status)

  Return `True` if the process has been stopped, otherwise return `False`.

  Availability: Unix.

`os.``WIFSIGNALED`(status)

  Return `True` if the process exited due to a signal, otherwise return `False`.

  Availability: Unix.

`os.``WIFEXITED`(status)

  Return `True` if the process exited using the exit(2) system call, otherwise return `False`.

  Availability: Unix.

`os.``WEXITSTATUS`(status)

  If `WIFEXITED(status)` is true, return the integer parameter to the exit(2) system call. Otherwise, the return value is meaningless.

  Availability: Unix.

`os.``WSTOPSIG`(status)

  返回导致进程停止的信号。

  Availability: Unix.

`os.``WTERMSIG`(status)

  Return the signal which caused the process to exit.

  Availability: Unix.

## 15.1.6. 其他系统信息

`os.``confstr`(name)

  返回字符串格式的系统配置信息。name 指定要查找的配置名称，它可以是字符串，是一个系统已定义的名称，这些名称定义在不同标准（POSIX，Unix 95，Unix 98 等）中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在 `confstr_names` 字典的键中给出。对于未包含在该映射中的配置名称，也可以传递一个整数作为 name。

  如果 name 指定的配置值未定义，返回 `None`。

  如果 name 是一个字符串且不是已定义的名称，将抛出 `ValueError` 异常。如果当前系统不支持 name 指定的配置名称，即使该名称存在于 `confstr_names`，也会抛出 `OSError` 异常，错误码为 `errno.EINVAL`。

  Availability: Unix

`os.``confstr_names`

  字典，表示映射关系，为 `confstr()` 可接受名称与操作系统为这些名称定义的整数值之间的映射。这可用于判断系统已定义了哪些名称。

  Availability: Unix.

`os.``getloadavg`()

  返回系统运行队列中最近 1、5 和 15 分钟内的平均进程数。无法获得平均负载则抛出 `OSError` 异常。

  Availability: Unix.

  2.3 新版功能.

`os.``sysconf`(name)

  返回整数格式的系统配置信息。如果 name 指定的配置值未定义，返回 `-1`。对 `confstr()` 的 name 参数的注释在此处也适用。当前已知的配置名称在 `sysconf_names` 字典中提供。

  Availability: Unix.

`os.``sysconf_names`

  字典，表示映射关系，为 `sysconf()` 可接受名称与操作系统为这些名称定义的整数值之间的映射。这可用于判断系统已定义了哪些名称。

  Availability: Unix.

以下数据值用于支持对路径本身的操作。所有平台都有定义。

对路径的高级操作在 `os.path` 模块中定义。

`os.``curdir`

  操作系统用来表示当前目录的常量字符串。在 Windows 和 POSIX 上是 `'.'`。在 `os.path` 中也可用。

`os.``pardir`

  操作系统用来表示父目录的常量字符串。在 Windows 和 POSIX 上是 `'..'`。在 `os.path` 中也可用。

`os.``sep`

  操作系统用来分隔路径不同部分的字符。在 POSIX 上是 `'/'`，在 Windows 上是是 `'\\'`。注意，仅了解它不足以能解析或连接路径，请使用 `os.path.split()` 和 `os.path.join()`，但它有时是有用的。在 `os.path` 中也可用。

`os.``altsep`

  操作系统用来分隔路径不同部分的替代字符。如果仅存在一个分隔符，则为 `None`。在 `sep` 是反斜杠的 Windows 系统上，该值被设为 `'/'`。在 `os.path` 中也可用。

`os.``extsep`

  分隔基本文件名与扩展名的字符，如 `os.py` 中的 `'.'`。在 `os.path` 中也可用。

  2.2 新版功能.

`os.``pathsep`

  操作系统通常用于分隔搜索路径（如 `PATH`）中不同部分的字符，如 POSIX 上是 `':'`，Windows 上是 `';'`。在 `os.path` 中也可用。

`os.``defpath`

  在环境变量没有 `'PATH'` 键的情况下，`exec*p*` and `spawn*p*` 使用的默认搜索路径。在 `os.path` 中也可用。

`os.``linesep`

  当前平台用于分隔（或终止）行的字符串。它可以是单个字符，如 POSIX 上是 `'\n'`，也可以是多个字符，如 Windows 上是 `'\r\n'`。在写入以文本模式（默认模式）打开的文件时，请不要使用 os.linesep 作为行终止符，请在所有平台上都使用一个 `'\n'` 代替。

`os.``devnull`

  空设备的文件路径。如 POSIX 上为 `'/dev/null'`，Windows 上为 `'nul'`。在 `os.path` 中也可用。

  2.4 新版功能.

## 15.1.7. Miscellaneous Functions

`os.``urandom`(n)

  Return a string of n random bytes suitable for cryptographic use.

  This function returns random bytes from an OS-specific randomness source. The returned data should be unpredictable enough for cryptographic applications, though its exact quality depends on the OS implementation. On a UNIX-like system this will query `/dev/urandom`, and on Windows it will use `CryptGenRandom()`. If a randomness source is not found, `NotImplementedError` will be raised.

  For an easy-to-use interface to the random number generator provided by your platform, please see `random.SystemRandom`.

  2.4 新版功能.