os模块篇（十六）

os.eventfd_write(fd, value)

os.eventfd_write(fd, value) 是 Python 中用于向事件文件描述符（eventfd）写入数据的函数。事件文件描述符是通过 os.eventfd() 创建的，用于进程间通信或线程间同步。

函数参数：

• fd: 事件文件描述符的整数文件描述符。
• value: 要写入事件文件描述符的整数值。这个值会加到事件文件描述符的当前值上。

函数返回值：

• os.eventfd_write() 函数返回写入的字节数，通常情况下是 8（因为事件文件描述符通常使用 64 位整数值）。

os.eventfd_write() 函数将指定的整数值加到事件文件描述符的当前值上。这个操作是非阻塞的，即使事件文件描述符的当前值为零，也不会导致写入操作阻塞。

下面是一个使用 os.eventfd_write() 的简单示例：

import os

# 创建一个初始值为 0 的事件文件描述符
eventfd = os.eventfd(0)

# 向事件文件描述符写入一个值
os.eventfd_write(eventfd, 1)

# 读取事件文件描述符的值，应该返回 1
event_value = os.eventfd_read(eventfd, 8)
print(f"Event value after writing 1: {event_value}")  # 输出: Event value after writing 1: 1

# 再次向事件文件描述符写入一个值
os.eventfd_write(eventfd, 2)

# 读取事件文件描述符的值，应该返回 3（1 + 2）
event_value = os.eventfd_read(eventfd, 8)
print(f"Event value after writing 2: {event_value}")  # 输出: Event value after writing 2: 3

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

在这个例子中，我们首先创建了一个初始值为 0 的事件文件描述符。然后，我们使用 os.eventfd_write() 向事件文件描述符写入了一个值 1，接着读取事件值，得到 1。接下来，我们再次写入一个值 2，并读取事件值，得到 3，这是因为事件值会累加。最后，我们关闭了事件文件描述符。

请注意，事件文件描述符的值可以用来表示事件的状态或条件。写入操作通常用于设置或触发事件，而读取操作用于检查事件是否被设置或触发。

os.timerfd_create(clockid, /, *, flags=0)

descriptor）。定时器文件描述符是一个可以用于定时操作的接口，它提供了一种在指定时间后接收通知的机制。这对于需要精确计时的应用程序非常有用，例如定时器、闹钟或者性能测量等。

参数说明如下：

• clockid：一个时钟标识符，指定了定时器应该使用哪个时钟源。这个参数通常是 os.CLOCK_REALTIME（表示使用实际时间）或 os.CLOCK_MONOTONIC（表示使用单调时间，不受系统时间变化的影响）。

• flags：一个可选的整数参数，用于指定文件描述符的行为。这个参数通常与标准文件打开模式标志一起使用，并且可以组合使用。目前，os.timerfd_create() 不支持任何特定的标志，因此这个参数通常设置为 0。

os.timerfd_create() 函数返回一个文件描述符，你可以使用这个文件描述符来设置定时器、获取定时器状态或者等待定时器到期。

下面是一个使用 os.timerfd_create() 的简单示例：

import os
import time

# 创建一个定时器文件描述符
timerfd = os.timerfd_create(os.CLOCK_REALTIME)

# 设置一个定时器，在 1 秒后到期
expires = os.timespec_get(time.time() + 1)
os.timerfd_settime(timerfd, 0, expires, 0)

# 等待定时器到期
os.read(timerfd, 8)

# 输出定时器到期的消息
print("Timer expired!")

# 关闭定时器文件描述符
os.close(timerfd)

在这个例子中，我们首先使用 os.timerfd_create() 创建了一个定时器文件描述符。然后，我们使用 os.timespec_get() 获取了当前时间加上 1 秒的时间点，并使用 os.timerfd_settime() 设置了一个定时器，使其在 1 秒后到期。接下来，我们使用 os.read() 阻塞等待定时器到期。一旦定时器到期，os.read() 将返回，我们可以输出一个消息表示定时器已经到期。最后，我们使用 os.close() 关闭了定时器文件描述符。

请注意，os.timerfd_create() 和相关的定时器操作函数提供了一种底层的接口，用于精确控制定时器的行为。如果你只是需要简单的定时功能，可能更倾向于使用 Python 的标准库中的 threading.Timer 或者 asyncio 库中的异步定时功能。

os.timerfd_settime(fd, /, *, flags=flags, initial=0.0, interval=0.0)

os.timerfd_settime() 是 Python 中的一个函数，用于设置定时器文件描述符（timerfd）的定时参数。这个函数允许你指定定时器应该在何时首次到期（initial），以及随后应该以多长的间隔到期（interval）。定时器文件描述符是通过 os.timerfd_create() 创建的，并且可以用于在特定的时间点接收通知。

参数说明如下：

• fd: 定时器文件描述符的整数文件描述符。
• flags: 一个可选的整数参数，用于指定设置时间时应该使用的标志。通常，这个参数设置为 0，表示使用默认的行为。也可以设置为 os.TFD_TIMER_ABSTIME，表示 initial 和 interval 参数是绝对时间（自 epoch 起的秒数和纳秒数），而不是相对时间（从当前时间开始的秒数和纳秒数）。
• initial: 一个浮点数，表示定时器首次到期之前应该等待的秒数。如果 flags 设置为 os.TFD_TIMER_ABSTIME，则 initial 表示的是绝对时间。
• interval: 一个浮点数，表示定时器到期之间的间隔秒数。如果设置为 0，定时器将只到期一次。如果 Flags 设置为 os.TFD_TIMER_ABSTIME，则 interval 也应该是一个绝对时间。

函数返回值：

• os.timerfd_settime() 函数返回一个元组，包含两个元素：old_value 和 old_interval。old_value 表示定时器之前的到期时间（以秒和纳秒为单位），old_interval 表示定时器之前的间隔（同样以秒和纳秒为单位）。

下面是一个使用 os.timerfd_settime() 的简单示例：

import os
import time

# 创建一个定时器文件描述符
timerfd = os.timerfd_create(os.CLOCK_REALTIME)

# 设置定时器在 2 秒后首次到期，之后每隔 1 秒到期
expires = os.timespec_get(time.time() + 2)
period = os.timespec_get(1)
os.timerfd_settime(timerfd, 0, expires, period)

# 等待定时器到期
os.read(timerfd, 8)
print("First timer expired!")

# 再次等待定时器到期
os.read(timerfd, 8)
print("Second timer expired!")

# 关闭定时器文件描述符
os.close(timerfd)

在这个例子中，我们首先使用 os.timerfd_create() 创建了一个定时器文件描述符。然后，我们使用 os.timespec_get() 获取了当前时间加上 2 秒的时间点，并将其设置为定时器的首次到期时间。我们还设置了一个 1 秒的间隔，意味着定时器将在首次到期后的每 1 秒再次到期。接下来，我们使用 os.read() 阻塞等待定时器到期，并在每次到期时输出消息。最后，我们使用 os.close() 关闭了定时器文件描述符。

os.timerfd_settime_ns(fd, /, *, flags=0, initial=0, interval=0)

os.timerfd_settime_ns() 是 Python 中用于设置定时器文件描述符（timerfd）的定时参数的另一个函数，它提供了纳秒级别的精度。与 os.timerfd_settime() 类似，这个函数也允许你指定定时器应该在何时首次到期（initial）以及随后的到期间隔（interval）。

参数说明如下：

• fd: 定时器文件描述符的整数文件描述符。
• flags: 一个可选的整数参数，用于指定设置时间时应该使用的标志。通常，这个参数设置为 0，表示使用默认的行为。也可以设置为 os.TFD_TIMER_ABSTIME，表示 initial 和 interval 参数是绝对时间（自 epoch 起的秒数、纳秒数），而不是相对时间（从当前时间开始的秒数、纳秒数）。
• initial: 一个整数，表示定时器首次到期之前应该等待的时间，单位是纳秒。如果 Flags 设置为 os.TFD_TIMER_ABSTIME，则 initial 表示的是绝对时间。
• interval: 一个整数，表示定时器到期之间的间隔，单位也是纳秒。如果设置为 0，定时器将只到期一次。如果 Flags 设置为 os.TFD_TIMER_ABSTIME，则 interval 也应该是一个绝对时间。。

函数返回值：

• os.timerfd_settime_ns() 函数返回一个元组，包含两个元素：old_value 和 old_intervalold_value 表示定时器之前的到期时间（以秒和纳秒为单位），old_interval 表示定时器之前的间隔（同样以秒和纳秒为单位）。

使用 os.timerfd_settime_ns() 可以提供更高的精度，特别是在需要精确控制定时器到期时间的场景中。

下面是一个使用 os.timerfd_settime_ns() 的简单示例：

import os
import time

# 创建一个定时器文件描述符
timerfd = os.timerfd_create(os.CLOCK_REALTIME)

# 设置定时器在 2 秒 500 毫秒（即 2500000000 纳秒）后首次到期，之后每隔 1 秒（即 1000000000 纳秒）到期
expires = int(time.time() * 1e9) + 2500000000  # 当前时间转换为纳秒并加上 2.5 秒
period = 1000000000  # 1 秒的纳秒表示

os.timerfd_settime_ns(timerfd, 0, expires, period)

# 等待定时器到期
os.read(timerfd, 8)
print("First timer expired!")

# 再次等待定时器到期
os.read(timerfd, 8)
print("Second timer expired!")

# 关闭定时器文件描述符
os.close(timerfd)

在这个例子中，我们使用 os.timerfd_settime_ns() 设置了定时器的到期时间和间隔，单位为纳秒。我们使用了 time.time() 函数获取当前时间，并将其转换为纳秒，然后加上所需的延迟时间来计算 expires 值。然后，我们设置了定时器，并使用 os.read() 等待它到期。一旦定时器到期，我们就可以读取文件描述符来重置它并继续执行后续操作。

os.timerfd_gettime(fd, /)

os.timerfd_gettime() 是 Python 中的一个函数，用于获取定时器文件描述符（timerfd）的当前时间和到期间隔。这个函数返回定时器的当前值以及到期间隔。

参数说明如下：

• fd: 定时器文件描述符的整数文件描述符。

函数返回值：

• os.timerfd_gettime() 函数返回一个元组，包含两个元素：value 和 interval。value 表示定时器当前的到期时间（以秒和纳秒为单位），interval 表示定时器当前的间隔（同样以秒和纳秒为单位）。

下面是一个使用 os.timerfd_gettime() 的简单示例：

import os
import time

# 创建一个定时器文件描述符
timerfd = os.timerfd_create(os.CLOCK_REALTIME)

# 设置定时器在 2 秒后首次到期，之后每隔 1 秒到期
expires = os.timespec_get(time.time() + 2)
period = os.timespec_get(1)
os.timerfd_settime(timerfd, 0, expires, period)

# 获取定时器的当前时间和间隔
current_time, interval = os.timerfd_gettime(timerfd)
print(f"Current time: {current_time.tv_sec} seconds, {current_time.tv_nsec} nanoseconds")
print(f"Interval: {interval.tv_sec} seconds, {interval.tv_nsec} nanoseconds")

# 等待定时器到期
os.read(timerfd, 8)
print("Timer expired!")

# 关闭定时器文件描述符
os.close(timerfd)

在这个例子中，我们首先创建了一个定时器文件描述符，并设置了定时器的到期时间和间隔。然后，我们使用 os.timerfd_gettime() 获取了定时器的当前时间和间隔，并打印了这些信息。接下来，我们使用 os.read() 阻塞等待定时器到期，并在到期时输出了一条消息。最后，我们关闭了定时器文件描述符。

请注意，os.timerfd_gettime() 返回的 value 和 interval 是 os.timespec 对象，它们包含 tv_sec（秒）和 tv_nsec（纳秒）两个属性。如果你需要将这些时间值转换为浮点数表示的秒数，可以使用 current_time.tv_sec + current_time.tv_nsec / 1e9 这样的表达式。

os.timerfd_gettime_ns(fd, /)

os.timerfd_gettime_ns() 是 Python 的一个函数，用于获取定时器文件描述符（timerfd）的当前时间和到期间隔，这些值都是以纳秒为单位的。这个函数返回一个元组，包含两个元素：当前定时器的到期时间（以纳秒为单位）和定时器的间隔（同样以纳秒为单位）。

参数 fd 是定时器文件描述符的整数文件描述符。

函数返回值：

• os.timerfd_gettime_ns() 返回一个元组，包含两个 os.timespec 对象。第一个对象表示当前定时器的到期时间（tv_sec 秒和 tv_nsec 纳秒），第二个对象表示定时器的间隔（tv_sec 秒和 tv_nsec 纳秒）。

下面是一个使用 os.timerfd_gettime_ns() 的示例：

import os
import time

# 创建一个定时器文件描述符
timerfd = os.timerfd_create(clockid=os.CLOCK_REALTIME)

# 设置定时器在 2 秒后首次到期，之后每隔 1 秒到期
expires = int(time.time() * 1e9) + 2 * 1e9  # 当前时间转换为纳秒并加上 2 秒
period = 1 * 1e9  # 1 秒的纳秒表示
os.timerfd_settime_ns(timerfd, 0, expires, period)

# 获取定时器的当前时间和间隔
current_time, interval = os.timerfd_gettime_ns(timerfd)

print(f"Current time: {current_time.tv_sec} seconds, {current_time.tv_nsec} nanoseconds")
print(f"Interval: {interval.tv_sec} seconds, {interval.tv_nsec} nanoseconds")

# 关闭定时器文件描述符
os.close(timerfd)

在这个例子中，我们创建了一个定时器文件描述符，并设置了定时器的到期时间和间隔。然后，我们使用 os.timerfd_gettime_ns() 获取了定时器的当前时间和间隔，并将它们打印出来。最后，我们关闭了定时器文件描述符。

请注意，os.timerfd_gettime_ns() 返回的 current_time 和 interval 是 os.timespec 对象，它们包含 tv_sec（秒）和 tv_nsec（纳秒）两个属性。如果你需要将这些时间值转换为浮点数表示的秒数，可以使用 current_time.tv_sec + current_time.tv_nsec / 1e9 这样的表达式。

os.getxattr(path, attribute, *, follow_symlinks=True)

os.getxattr() 是 Python 中的一个函数，用于获取文件或目录的扩展属性（extended attribute）。这些扩展属性提供了一种在文件系统中存储与文件或目录关联的额外数据的方式。这些数据不是文件的内容，而是与文件或目录的元数据相关联。

函数的参数说明如下：

• path: 文件或目录的路径。
• attribute: 要获取的扩展属性的名称。
• follow_symlinks: 一个布尔值，默认为 True。如果为 True，并且路径是一个符号链接，则该函数将遵循符号链接以获取其目标文件或目录的扩展属性。如果为 False，则直接对符号链接本身执行操作。

函数返回值：

• os.getxattr() 函数返回一个字节串（bytes），包含指定扩展属性的值。

如果文件或目录没有指定的扩展属性，或者如果路径不存在，则该函数将引发 OSError 异常。

下面是一个使用 os.getxattr() 的简单示例：

import os

# 假设我们有一个文件，并且我们想要获取它的一个扩展属性
file_path = 'example.txt'
attribute_name = 'user.comment'

try:
    # 获取扩展属性的值
    attribute_value = os.getxattr(file_path, attribute_name)
    print(f"The value of the extended attribute '{attribute_name}' is: {attribute_value}")
except OSError as e:
    # 如果文件或目录没有该扩展属性，或者路径不存在，将捕获 OSError 异常
    print(f"An error occurred: {e}")

在这个示例中，我们尝试获取名为 ‘user.comment’ 的扩展属性的值。如果该属性存在于 example.txt 文件中，它的值将被打印出来。否则，将捕获并打印出 OSError 异常。

请注意，扩展属性的支持和具体用法可能因操作系统和文件系统而异。并非所有文件系统都支持扩展属性，并且不同的文件系统可能有不同的扩展属性名称空间和限制。在使用 os.getxattr() 之前，请确保您的系统支持扩展属性，并熟悉您的文件系统的具体用法和限制。

os.listxattr(path=None, *, follow_symlinks=True)

os.listxattr() 是 Python 中的一个函数，用于列出文件或目录的所有扩展属性（extended attributes）的名称。扩展属性是一种在文件系统中与文件或目录关联的元数据，它们不是文件内容的一部分，而是附加在文件或目录上的。

函数的参数说明如下：

• path: 文件或目录的路径。如果未指定，则使用当前工作目录。
• follow_symlinks: 一个布尔值，默认为 True。如果为 True，并且路径是一个符号链接，则该函数将遵循符号链接以获取其目标文件或目录的扩展属性列表。如果为 False，则直接对符号链接本身执行操作。

函数返回值：

• os.listxattr() 函数返回一个列表，其中包含文件或目录的所有扩展属性的名称。

如果路径不存在或发生其他错误，该函数将引发 OSError 异常。

下面是一个使用 os.listxattr() 的示例：

import os

# 指定一个文件或目录的路径
path = 'example.txt'

try:
    # 列出文件的所有扩展属性名称
    xattr_names = os.listxattr(path)
    print(f"The extended attributes of '{path}' are: {xattr_names}")
except OSError as e:
    # 如果文件或目录不存在，或者发生其他错误，将捕获 OSError 异常
    print(f"An error occurred: {e}")

在这个示例中，我们尝试列出名为 example.txt 的文件的所有扩展属性名称。如果文件存在且包含扩展属性，这些属性的名称将被打印出来。如果文件不存在或发生其他错误，将捕获并打印出 OSError 异常。

请注意，扩展属性的支持和具体用法可能因操作系统和文件系统而异。并非所有文件系统都支持扩展属性，并且不同的文件系统可能有不同的扩展属性名称空间和限制。在使用 os.listxattr() 之前，请确保您的系统支持扩展属性，并熟悉您的文件系统的具体用法和限制。