pybootd 1.5.0

[logger]部分

type

日志记录器的类型，如果有。可以是stderr，file，syslog或none。

level

日志记录器详细程度的级别。可以是critical，error，info或debug。

file

如果type设置为file，则输出日志文件的路径。

[bootp]部分

access

访问控制列表的类型。如果没有定义此选项，只要定义的池未耗尽，就会为所有BOOTP请求提供服务。可以是以下选项之一

• mac：根据请求者的MAC地址过滤掉传入的BOOTP请求。

• uuid：根据请求的UUID对传入的PXE请求进行过滤。UUID不会从简单的BOOTP或DHCP客户端发出，因此此选项仅对启用PXE的客户端有意义。

• http：通过简单的HTTP GET请求将传入请求转发到另一个主机。如果存在，将MAC地址和UUID发送到HTTP服务器，服务器回复允许或拒绝请求者的访问。

应该存在一个以所选选项命名的部分来定义访问列表。

地址

指定监听接收传入BOOTP请求的网络的地址。在大多数主机上，唯一的有效地址是0.0.0.0。一些主机接受子网（例如192.168.1.0）。建议不要定义此选项，而使用ACL拒绝客户端。具有多个网络接口的主机可能无法监听单个网络。实现此类功能需要使用原始套接字，这超出了此简单服务器的范围。

allow_simple_dhcp

默认行为是期望PXE请求。为了服务简单的BOOTP或DHCP请求，应启用此选项。此选项接受布尔值。

boot_file

发送回BOOTP客户端的启动文件名，客户端通常在分配网络地址后通过TFTP请求此类文件以启动。

域名

客户端FQDN的域名部分，即网络域名。

dns

DNS服务器的IP地址。服务器只接受单个地址。

lease_time

DHCP租约的有效性（以秒为单位）。请注意，BOOTP守护程序不管理租约到期；因此，此值几乎没有意义。

pool_start

为BOOT客户端分配的第一个地址。

pool_count

可以服务的最大客户端数量。

notify

当定义时，将UDP通知消息发送到定义的IP地址和端口（使用列分隔符：a.b.c.d:p），每当客户端向BOOTP守护程序请求IP地址时。

端口

传入BOOTP请求的替代端口。

timeout

当启用ACL并设置为使用HTTP协议时，从远程认证主机接收响应的超时时间（以秒为单位）。如果未从远程主机收到答案，BOOTP守护程序将忽略传入的BOOTP/DHCP请求。

servername

BOOTP服务器的名称。

[mac]部分

[mac]部分包含一个条目，用于允许或阻止每个MAC地址。每个条目的值是一个布尔值，即

AA-BB-CC-DD-EE-FF = enable

[uuid]部分

[uuid]部分包含一个条目，用于允许或阻止每个UUID。每个条目的值是一个布尔值，即

xxxxxxxx-aaaa-bbbb-cccc-yyyyyyyyyyyy = enable

[http]部分

位置

用于联系远程服务器以获取引导权限的URL前缀。

pxe

当请求者发出PXE信息时，将其附加到URL前缀的路径。具有PXE功能的普通PC在BIOS启动时发出PXE引导请求。因此，远程HTTP服务器可以在从pybootd守护程序接收到此类请求时识别BIOS引导序列。

dhcp

当请求者发出简单DHCP信息时，将其附加到URL前缀的路径。普通OS在启动时发出简单的DHCP请求。因此，远程HTTP服务器可以在从pybootd守护程序接收到此类请求时识别OS引导序列。

pxe/dhcp选项对允许远程HTTP服务器识别引导阶段：是BIOS初始化还是操作系统引导序列。当这种区分没有用时，这两个选项可以指向相同的路径。

[tftp] 部分

地址

监听传入TFTP请求的地址。当启用BOOTP守护进程时，最好省略此选项，因为地址会自动从BOOTP守护进程接收。

blocksize

每个交换数据块的大小。建议保留默认值，因为一些客户端可能不接受其他值。

端口

传入TFTP请求的备用端口。

timeout

等待从TFTP客户端收到确认的超时时间（秒）。如果超时到期，TFTP服务器将重新发送最后一个数据包。它可以表示为一个实数值。

root

TFTP服务的根目录。此路径会自动添加到从TFTP客户端发出的路径名之前。它可以是一个相对路径，绝对路径，或者访问远程文件的URL前缀。

• 一个相对路径到守护进程目录，当root选项以./开头时；

• 一个绝对路径，当root选项以/开头时；

• 一个URL前缀，用于访问远程文件。

[filters] 部分

filters部分允许动态路径名转换。当TFTP客户端请求某些特定文件名时，tftp服务器可以将它们转换为其他文件。

此选项有助于为任何远程客户端提供相同的配置文件（例如，pxelinux.cfg），从而加快引导过程。此选项还允许访问不在当前配置路径中存储的文件（见root选项）。

filters部分的每个选项代表一个匹配文件模式的模式。它接受标准通配符：*和?。选项的值定义了转换后的路径。

value部分可以包含变量。变量用大括号括起来，例如{varname}。

目前，唯一支持的变量是filename，它会被替换为实际请求的文件名。

value部分还可以包含一个特殊标记，告诉tftp守护进程从文件中读取替换模式。这个特殊标记应该用大括号括起来，例如[file]。

示例

以下过滤器

pxelinux.cfg/* = pybootd/etc/pxe.cfg

告诉tftp服务器，所有匹配pxelinux.cfg/*模式的客户端请求应提供pybootd/etc/pxe.cfg文件。这防止客户端在最终回退到简单的pxelinux.cfg文件之前，执行通常耗时回退请求，使用UUID、MAC和后缀地址。

以下过滤器

startup = [dir/{filename}.cfg]

告诉tftp服务器，当请求启动文件时，它应从dir/startup.cfg文件中读取实际的文件名。