os模块篇（十）

os.unlockpt(fd, /)

os.unlockpt(fd) 是 Python 的 os 模块中的一个函数，用于解锁由 os.grantpt(fd) 创建的伪终端。

伪终端（pseudo-terminal，简称 pty）是 Unix 和类 Unix 系统中的一个概念，它模拟了一个物理终端的行为。伪终端常常用于 shell 会话、远程终端访问（如 SSH）以及终端仿真程序等。

os.grantpt(fd) 函数用于使调用进程成为新的伪终端的从设备（slave）的唯一所有者，并返回一个文件描述符，该文件描述符可以用于访问这个从设备。当调用 os.grantpt(fd) 后，该伪终端会被锁定，以防止其他进程访问它。

os.unlockpt(fd) 函数则用于解锁之前由 os.grantpt(fd) 锁定的伪终端。解锁后，其他进程就可以访问这个伪终端了。

下面是一个简单的例子，展示了如何使用 os.openpty(), os.grantpt(), 和 os.unlockpt() 来创建一个伪终端：

import os

# 创建一个新的伪终端对
master_fd, slave_name = os.openpty()

# 锁定伪终端，使其成为当前进程的唯一所有者
os.grantpt(master_fd)

# 解锁伪终端，使其可以被其他进程访问
os.unlockpt(master_fd)

# 使用 master_fd 和 slave_name 进行进一步的操作，例如启动一个子进程并将其附加到伪终端的 slave 设备上

需要注意的是，os.unlockpt(fd) 只是解锁了伪终端，但并没有关闭文件描述符 fd。在使用完伪终端后，你应该使用 os.close(fd) 来关闭文件描述符，以避免资源泄露。

os.write(fd, str, /)

os.write(fd, str, /) 是 Python 的 os 模块中的一个低级函数，用于将字节字符串 str 写入文件描述符 fd 所引用的文件或设备。fd 是一个整数，它代表一个已经打开的文件或设备的文件描述符。str 是要写入的数据，它必须是一个字节字符串（bytes 类型）。

这个函数返回实际写入的字节数。如果写入操作被信号中断，它会返回一个负数。

这里有一个简单的例子，展示了如何使用 os.open(), os.write(), 和 os.close() 来创建一个文件并写入一些数据：

import os

# 打开一个文件以写入数据，'w' 表示写入模式
fd = os.open('example.txt', os.O_WRONLY | os.O_CREAT)

# 要写入的数据，需要是字节字符串
data = b'Hello, world!'

# 写入数据
bytes_written = os.write(fd, data)

# 关闭文件描述符
os.close(fd)

print(f"Wrote {bytes_written} bytes to the file.")

在这个例子中，os.open() 用于以写入模式打开一个文件，并返回一个文件描述符。然后，os.write() 用于将字节字符串 data 写入这个文件。最后，os.close() 用于关闭文件描述符，这是一个好习惯，因为它会释放系统资源。

注意，os.write() 是一个低级的文件操作函数，通常在更高级的文件 I/O 函数（如 open() 和 write() 方法）无法满足需求时才会使用。在大多数情况下，使用更高级的函数会更简单、更安全。例如，使用 open() 函数和文件对象的 write() 方法：

with open('example.txt', 'wb') as file:
    file.write(b'Hello, world!')

这个代码片段做的事情与前面的例子相同，但它使用了更高级的文件操作方式，并且不需要显式地关闭文件，因为 with 语句会在退出时自动处理。

os.writev(fd, buffers, /)

os.writev(fd, buffers, /) 是 Python 的 os 模块中的一个函数，它提供了一种更高效的写入方式，可以一次性向文件描述符 fd 写入多个数据缓冲区。这个函数是 write() 函数的一个扩展，允许你同时写入多个缓冲区，而不需要在它们之间多次调用系统调用。

fd 是要写入的文件或设备的文件描述符，buffers 是一个元组，其中包含要写入的数据缓冲区。每个缓冲区可以是一个字节字符串（bytes 类型）或一个 memoryview 对象。

os.writev() 函数返回实际写入的字节总数。

下面是一个使用 os.writev() 的例子：

import os

# 打开一个文件以写入数据
fd = os.open('example.txt', os.O_WRONLY | os.O_CREAT)

# 准备要写入的数据缓冲区
buffers = [b'Hello, ', b'world!']

# 使用 writev 一次性写入多个缓冲区
bytes_written = os.writev(fd, buffers)

# 关闭文件描述符
os.close(fd)

print(f"Wrote {bytes_written} bytes to the file.")

在这个例子中，buffers 是一个包含两个字节字符串的列表。os.writev() 将这两个字节字符串一次性写入文件，而不需要先写入第一个字符串，然后再写入第二个字符串。这可以减少系统调用的次数，从而提高效率。

需要注意的是，os.writev() 是一个低级的文件操作函数，通常在你需要更精细地控制文件写入时才会使用。在大多数情况下，使用更高级的文件操作函数（如 open() 和文件对象的 write() 方法）会更加简单和直观。

os.get_terminal_size(fd=STDOUT_FILENO, /)

os.get_terminal_size(fd=STDOUT_FILENO) 是 Python 的 os 模块中的一个函数，用于获取与文件描述符 fd 关联的终端的大小。通常，这个函数用于获取标准输出（stdout）终端的大小，但也可以用于其他文件描述符，只要它们与终端相关联。

fd 参数是一个文件描述符，通常是一个整数。STDOUT_FILENO 是一个常量，其值为 1，表示标准输出的文件描述符。如果 fd 没有指定，或者为 None，则默认使用 STDOUT_FILENO。

该函数返回一个具有两个属性的命名元组 os.terminal_size，即 columns 和 lines，分别表示终端的列数和行数。这些值表示终端的宽度和高度，以字符单元为单位。

下面是一个简单的例子，展示了如何使用 os.get_terminal_size() 来获取标准输出终端的大小：

import os

# 获取标准输出终端的大小
size = os.get_terminal_size()

# 输出终端的列数和行数
print(f"Columns: {size.columns}, Lines: {size.lines}")

在上面的例子中，size 是一个具有 columns 和 lines 属性的命名元组，分别表示终端的宽度和高度。这些值可以用来确定在终端中显示文本时应该使用多少空间。

请注意，如果文件描述符 fd 不与终端相关联，或者如果终端大小无法确定，os.get_terminal_size() 可能会引发 OSError 异常。

os.get_inheritable(fd, /)

os.get_inheritable(fd, /) 是 Python 的 os 模块中的一个函数，用于检查文件描述符 fd 是否可以被继承。文件描述符的继承是指当父进程创建一个子进程时，父进程中的某些文件描述符（如打开的文件、套接字等）可以被子进程继承。

fd 参数是要检查的文件描述符。该函数返回一个布尔值，True 表示文件描述符可以被继承，False 表示不可以。

默认情况下，通过 os.open() 或其他系统调用打开的文件描述符通常是可以被继承的。但是，你可以使用 os.set_inheritable() 函数来更改文件描述符的继承属性。

下面是一个例子，展示了如何使用 os.get_inheritable() 来检查文件描述符的继承属性：

import os

# 打开一个文件
fd = os.open('example.txt', os.O_RDONLY)

# 检查文件描述符是否可以被继承
is_inheritable = os.get_inheritable(fd)

print(f"File descriptor {fd} is inheritable: {is_inheritable}")

# 关闭文件描述符
os.close(fd)

如果你想要改变文件描述符的继承属性，你可以使用 os.set_inheritable() 函数。例如，要禁止一个文件描述符被子进程继承，你可以这样做：

import os

# 打开一个文件
fd = os.open('example.txt', os.O_RDONLY)

# 禁止文件描述符被子进程继承
os.set_inheritable(fd, False)

# 再次检查文件描述符的继承属性
is_inheritable = os.get_inheritable(fd)

print(f"File descriptor {fd} is now inheritable: {is_inheritable}")

# 关闭文件描述符
os.close(fd)

在上面的例子中，我们首先检查了一个文件描述符的继承属性，然后通过 os.set_inheritable() 禁止它被子进程继承，并再次检查其属性以确认更改。

文件描述符的继承属性在创建子进程时很重要，因为它们决定了哪些资源会被子进程共享。在某些情况下，你可能不希望子进程继承某些文件描述符，以避免资源泄漏或其他问题。

os.set_inheritable(fd, inheritable, /)

os.set_inheritable(fd, inheritable, /) 是 Python 的 os 模块中的一个函数，用于设置文件描述符 fd 是否可以被继承。当父进程创建一个子进程时，如果文件描述符是可继承的，那么该文件描述符将被子进程继承。

fd 参数是要设置继承属性的文件描述符，通常是一个整数。inheritable 参数是一个布尔值，如果为 True，则文件描述符将被设置为可继承的；如果为 False，则文件描述符将被设置为不可继承的。

这个函数没有返回值，它仅仅改变文件描述符的继承属性。

下面是一个使用 os.set_inheritable() 的例子：

import os

# 打开一个文件
fd = os.open('example.txt', os.O_RDONLY)

# 设置文件描述符为不可继承
os.set_inheritable(fd, False)

# 创建一个子进程
import subprocess
subprocess.Popen(['ls'])

# 关闭文件描述符
os.close(fd)

在这个例子中，我们首先打开了一个文件并获取了它的文件描述符 fd。然后，我们使用 os.set_inheritable() 将 fd 设置为不可继承。这意味着，如果我们在这个点创建一个子进程，子进程将不会继承这个文件描述符。最后，我们关闭了文件描述符。

文件描述符的继承属性在某些情况下非常重要。例如，如果你正在编写一个需要创建子进程的程序，并且你不希望子进程继承某些打开的文件描述符（以避免资源泄露或意外行为），那么你需要使用 os.set_inheritable() 来确保这些文件描述符在子进程中是不可用的。

请注意，在创建子进程之前设置文件描述符的继承属性是很重要的，因为在 fork() 或 Popen() 调用之后通常无法再更改这些属性。如果子进程已经创建，那么文件描述符的继承属性就已经确定了。

os.access(path, mode, *, dir_fd=None, effective_ids=False, follow_symlinks=True)

os.access(path, mode, *, dir_fd=None, effective_ids=False, follow_symlinks=True) 是 Python 的 os 模块中的一个函数，用于检查调用进程是否有权限访问指定的路径。这个函数基于真实用户 ID 和真实组 ID 进行权限检查，而不是有效用户 ID 和有效组 ID。

参数说明：

• path：要检查的路径（文件或目录）。
• mode：要检查的权限模式，可以是以下常量之一或它们的组合：
  • os.F_OK：测试路径是否存在。
  • os.R_OK：测试读权限。
  • os.W_OK：测试写权限。
  • os.X_OK：测试执行权限。
• dir_fd（可选）：一个文件描述符，用于解释相对路径。如果提供，path 应该是相对于该文件描述符所指目录的相对路径。
• effective_ids（可选）：如果为 True，则使用有效用户 ID 和有效组 ID 进行权限检查，而不是真实用户 ID 和真实组 ID。默认为 False。
• follow_symlinks（可选）：如果为 True，则解析符号链接以检查目标文件或目录的权限。如果为 False，则直接检查符号链接本身的权限。默认为 True。

返回值：

• 如果调用进程具有指定的权限，则返回 True。
• 否则返回 False。

下面是一个使用 os.access 的例子：

import os

# 检查文件是否存在
if os.access("/path/to/file", os.F_OK):
    print("File exists.")

# 检查文件是否有读权限
if os.access("/path/to/file", os.R_OK):
    print("File is readable.")

# 检查文件是否有写权限
if os.access("/path/to/file", os.W_OK):
    print("File is writable.")

# 检查文件是否有执行权限
if os.access("/path/to/file", os.X_OK):
    print("File is executable.")

请注意，os.access() 函数可能不是检查文件权限的最佳方式，因为它基于实际文件系统权限，而不是进程的实际有效权限。在复杂的权限场景中，使用 os.access() 可能会导致意外的结果。例如，即使 os.access() 返回 True，尝试打开或操作文件时仍然可能会遇到权限错误。因此，在实际的文件操作中直接处理可能发生的权限错误通常是更可靠的做法。