Manpages

deleteprinter command (G)

With the introduction of MS-RPC based printer support for Windows NT/2000 clients in Samba 2.2, it is now possible to delete printer at run time by issuing the DeletePrinter() RPC call.

For a Samba host this means that the printer must be physically deleted from underlying printing system. The deleteprinter command defines a script to be run which will perform the necessary operations for removing the printer from the print system and from smb.conf.

The deleteprinter command is automatically called with only one parameter: "printer name".

Once the deleteprinter command has been executed, smbd will reparse the smb.conf to associated printer no longer exists. If the sharename is still valid, then smbd will return an ACCESS_DENIED error to the client.

参 见 addprinter command, printing, show add printer wizard

缺 省 设 置 : none

示 例 : deleteprinter command = /usr/bin/removeprinter

delete readonly (S)

这 个 选 项 允 许 删 除 只 读 文 件 ,这 个 只 读 不 是 通 常 dos里 的 含 义 ,而 是 unix中 的 .

这 个 选 项 对 于 rcs这 样 的 应 用 很 有 用 ,在 这 种 情 况 下 ,unix文 件 的 属 主 不 允 许 改 变 权 限 ,dos文 件 只 读 .

缺 省 设 置 : delete readonly = no

delete share command (G)

Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server Manager. The delete share command is used to define an external program or script which will remove an existing service definition from smb.conf. In order to successfully execute the delete share command, smbd requires that the administrator be connected using a root account (i.e. uid == 0).

When executed, smbd will automatically invoke the delete share command with two parameters.

configFile - the location of the global smb.conf file.

shareName - the name of the existing service.

This parameter is only used to remove file shares. To delete printer shares, see the deleteprinter command.

参 见 add share command, change share command.

缺 省 设 置 : none

示 例 : delete share command = /usr/local/bin/delshare

delete user from group script (G)

Full path to the script that will be called when a user is removed from a group using the Windows NT domain administration tools. It will be run by smbd(8) AS ROOT. Any %g will be replaced with the group name and any %u will be replaced with the user name.

缺 省 设 置 : delete user from group script =

示 例 : delete user from group script = /usr/sbin/deluser %u %g

delete user script (G)

它 定 义 一 个 在 使 用 RPC(NT)工 具 管 理 用 户 时 ， fBsmbd(8)以 root身 份 运 行 的 包 括 路 径 的 一 个 脚 本 .

当 远 程 客 户 使 用 ’User Manager for Domains’ 或 是 rpcclient 从 服 务 器 上 删 除 一 个 用 户 时 执 行 此 操 作 。

这 个 脚 本 删 除 给 定 的 unix用 户 。

缺 省 设 置 : delete user script = <空 字 符 串 >

示 例 : delete user script = /usr/local/samba/bin/del_user %u

delete veto files (S)

这 个 选 项 用 于 samba试 图 删 除 一 个 或 多 个 包 含 禁 止 文 件 的 目 录 的 情 况 (参 见 veto files选 项 ). 如 果 这 个 选 项 设 置 为 no(缺 省 情 况 ),那 么 如 果 一 个 禁 止 目 录 里 包 含 了 任 何 非 禁 止 的 文 件 或 目 录 ,删 除 就 会 失 败 .这 通 常 正 是 你 所 希 望 的 .

如 果 这 个 选 项 被 设 为 了 yes,Samba将 试 图 递 归 删 除 在 被 禁 止 目 录 里 的 任 何 文 件 和 目 录 .这 对 于 整 合 象 NetAtalk这 样 的 文 件 服 务 系 统 很 有 用 ,它 通 常 会 在 目 录 里 生 成 Dos/windows用 户 看 不 见 的 中 间 文 件 (e.g. .AppleDouble).

设 置 delete veto files = yes 使 那 些 有 权 限 的 用 户 可 以 在 删 除 父 目 录 的 时 候 透 明 的 删 除 子 目 录 .

参 见 veto files 选 项 .

缺 省 设 置 : delete veto files = no

deny hosts (S)

与 hosts deny 同 义 .

dfree command (G)

dfree command只 需 在 磁 盘 空 间 计 算 有 问 题 的 系 统 上 使 用 .这 个 空 间 计 算 的 问 题 仅 在 Ultrix系 统 上 发 生 过 ,但 在 其 他 的 操 作 系 统 上 也 有 可 能 发 生 .发 生 这 个 问 题 的 现 象 是 在 每 个 目 录 列 表 最 后 发 生 错 误 并 提 示 "Abort Retry Ignore".

这 个 设 置 允 许 用 外 部 程 序 代 替 内 部 程 序 来 计 算 总 共 的 磁 盘 空 间 和 可 用 的 磁 盘 空 间 .下 面 的 例 子 给 出 了 一 个 能 完 成 这 个 功 能 的 脚 本 .

这 个 外 部 程 序 的 输 入 是 文 件 系 统 里 一 个 需 要 计 算 的 目 录 ,典 型 的 包 括 ./字 符 串 .以 ascii码 返 回 两 个 整 数 .第 一 个 是 总 共 的 磁 盘 空 间 (以 块 为 单 位 ),第 二 个 是 可 用 块 树 .可 选 的 第 三 个 返 回 值 可 以 以 字 节 为 单 位 给 出 块 的 大 小 .缺 省 的 块 的 大 小 是 1024字 节 .

注 意 :这 个 脚 本 应 该 属 主 为 root,只 有 root可 写 ,并 且 不 能 带 有 用 户 标 识 位 和 组 标 识 位 (setuid or setgid)!

缺 省 设 置 : 缺 省 用 内 部 程 序 来 计 算 磁 盘 容 量 和 可 用 空 间 .

示 例 : dfree command = /usr/local/samba/bin/dfree

如 下 这 个 dfree脚 本 必 须 是 可 执 行 的 .

#!/bin/sh
df $1 | tail -1 | awk ’{print $2" "$4}’

在 Sys V一 类 的 系 统 上 可 能 是 :

#!/bin/sh
/usr/bin/df -k $1 | tail -1 | awk ’{print $3" "$5}’

注 意 在 特 定 的 系 统 上 可 能 需 要 给 出 相 应 的 带 有 全 路 径 的 命 令 .

directory (S)

与 path 同 义 .

directory mask (S)

这 个 选 项 是 8进 制 的 模 式 。 用 来 控 制 在 生 成 UNIX目 录 时 ， 将 其 从 dos模 式 转 换 为 unix模 式 。

当 生 成 一 个 路 径 的 时 候 ,必 须 指 定 的 目 录 权 限 从 dos模 式 映 射 到 unix模 式 ,然 后 这 个 结 果 和 这 个 选 项 进 行 逐 位 的 与 运 算 .这 个 选 项 可 以 理 解 成 unix模 式 下 的 位 掩 码 .这 个 选 项 里 任 何 没 有 设 置 的 位 在 生 成 unix下 的 目 录 时 将 会 被 去 掉

缺 省 情 况 下 ,这 个 选 项 把 组 和 其 他 用 户 的 写 权 限 位 去 掉 ,只 允 许 目 录 的 属 主 对 目 录 进 行 修 改 .

Samba将 把 这 个 选 项 和 force directory mode的 选 项 进 行 逐 位 的 或 运 算 ,这 个 选 项 缺 省 时 设 置 为 000(也 就 是 不 加 额 外 的 限 制 ).

Note that this parameter does not apply to permissions set by Windows NT/2000 ACL editors. If the administrator wishes to enforce a mask on access control lists also, they need to set the directory security mask.

在 生 成 目 录 时 如 果 需 要 设 置 特 殊 的 模 式 位 ,参 见 force directory mode选 项 .

关 于 生 成 文 件 时 的 模 式 位 参 见 create mode 选 项 和 directory security mask选 项 .

Also refer to the inherit permissions parameter.

缺 省 设 置 : directory mask = 0755

示 例 : directory mask = 0775

directory mode (S)

与 directory mask 同 义 。

directory security mask (S)

此 选 项 控 制 了 NT客 户 在 他 的 本 地 NT安 全 对 话 框 中 操 纵 unix目 录 权 限 时 可 以 修 改 哪 些 权 限 位 .

这 个 选 项 以 掩 码 来 实 现 改 变 权 限 位 ,所 以 在 修 改 时 要 防 止 不 在 掩 码 中 涉 及 的 那 些 位 .实 际 上 ,在 这 个 掩 码 中 的 位 0可 以 使 用 户 无 法 改 变 任 何 东 东 .

如 果 没 有 明 确 设 定 的 话 ,这 个 选 项 会 用 与 directory mask选 项 同 样 的 值 .要 允 许 用 户 在 目 录 中 可 以 修 改 所 有 的 user/group/world权 限 ,可 以 把 这 个 选 项 设 为 0777.

注 意 ,能 访 问 samba服 务 器 的 用 户 通 过 其 它 方 法 也 可 以 很 容 易 地 绕 过 这 个 限 制 ,所 以 对 独 立 工 作 的 系 统 来 说 这 个 选 项 是 最 根 本 最 有 用 的 .很 多 系 统 管 理 的 管 理 员 都 会 把 它 设 为 默 认 的 0777.

参 见 force directory security mode, security mask, force security mode 选 项 。

缺 省 设 置 : directory security mask = 0777

示 例 : directory security mask = 0700

disable netbios (G)

Enabling this parameter will disable netbios support in Samba. Netbios is the only available form of browsing in all windows versions except for 2000 and XP.

Note that clients that only support netbios won’t be able to see your samba server when netbios support is disabled.

缺 省 设 置 : disable netbios = no

示 例 : disable netbios = yes

disable spoolss (G)

Enabling this parameter will disable Samba’s support for the SPOOLSS set of MS-RPC’s and will yield identical behavior as Samba 2.0.x. Windows NT/2000 clients will downgrade to using Lanman style printing commands. Windows 9x/ME will be uneffected by the 选 项 。 However, this will also disable the ability to upload printer drivers to a Samba server via the Windows NT Add Printer Wizard or by using the NT printer properties dialog window. It will also disable the capability of Windows NT/2000 clients to download print drivers from the Samba host upon demand. Be very careful about enabling this 选 项 。

See also use client driver

Default : disable spoolss = no

display charset (G)

Specifies the charset that samba will use to print messages to stdout and stderr and SWAT will use. Should generally be the same as the unix charset.

缺 省 设 置 : display charset = ASCII

示 例 : display charset = UTF8

dns proxy (G)

指 定 nmbd(8)象 WINS服 务 器 那 样 寻 找 没 有 登 记 的 NetBIOS名 ,象 对 待 DNS名 那 样 逐 字 的 对 待 NetBIOS名 ,向 DNS服 务 器 查 询 该 名 称 所 代 表 的 客 户 端 .

注 意 ,NetBISO名 的 最 大 长 度 是 15个 字 符 ,所 以 DNS名 (或 DNS别 名 )同 样 最 多 只 能 有 15个 字 符 .

nmbd 在 做 DNS名 查 询 的 时 候 将 自 身 复 制 一 份 ,因 为 域 名 查 询 是 一 个 阻 塞 的 动 作 .

参 见 wins support 。

缺 省 设 置 : dns proxy = yes

domain logons (G)

如 果 这 个 选 项 为 yes,Samba服 务 器 将 为 workgroup提 供 Windows 95/98 登 陆 域 服 务 .Samba 2.2只 能 实 现 Windows NT 4 域 中 域 控 制 器 的 有 限 功 能 。 有 关 设 置 这 个 功 能 的 更 详 细 信 息 参 见 Samba 文 档 中 的 Samba-PDC-HOWTO。

缺 省 设 置 : domain logons = no

domain master (G)

这 个 选 项 告 诉 smbd(8)收 集 广 域 网 内 的 浏 览 列 表 .设 置 这 个 选 项 后 ,nmbd用 一 个 特 定 的 NetBIOS名 向 它 的 工 作 组 标 识 它 自 己 是 一 个 主 控 浏 览 器 .在 同 一 工 作 组 不 同 子 网 中 的 本 地 主 控 浏 览 器 将 把 自 己 的 浏 览 列 表 传 给 nmbd,然 后 向 smbd(8) 请 求 整 个 网 络 上 浏 览 列 表 的 完 整 拷 贝 .客 户 端 将 和 他 们 的 本 地 主 控 浏 览 器 联 系 ,得 到 整 个 域 范 围 内 的 浏 览 列 表 ,而 不 只 是 子 网 上 的 列 表 .

注 意 ,windows NT主 域 控 制 器 默 认 情 况 总 是 占 有 这 个 在 工 作 组 中 的 特 殊 的 NetBIOS名 ， 宣 称 自 己 是 工 作 组 的 主 域 浏 览 器 (也 就 是 说 ,没 有 什 么 方 法 可 以 阻 止 一 个 Windows NT主 域 控 制 器 这 样 做 ). 这 样 如 果 设 置 了 这 个 选 项 ,并 且 nmbd 在 Windows NT之 前 向 工 作 组 宣 称 了 这 个 特 殊 的 名 字 ,那 么 跨 子 网 的 浏 览 行 为 会 变 得 奇 怪 ,并 且 可 能 会 失 败 .

If domain logons = yes , then the default behavior is to enable the domain master 选 项 。 If domain logons is not enabled (the default setting), then neither will domain master be enabled by default.

缺 省 设 置 : domain master = auto

dont descend (S)

有 些 系 统 上 存 在 某 些 特 殊 的 路 径 (比 如 linux中 的 /proc),这 些 目 录 不 需 要 (也 不 希 望 )客 户 端 关 心 ,甚 至 可 能 具 有 无 限 的 层 次 深 度 (递 归 的 ).这 个 选 项 允 许 你 指 定 一 个 由 逗 号 分 隔 的 列 表 ,服 务 器 将 把 列 表 内 包 含 的 目 录 始 终 显 示 成 空 目 录 .

注 意 ,Samba对 ’dont descend’选 项 的 输 入 格 式 十 分 挑 剔 .例 如 他 也 许 要 求 你 输 入 ./proc而 不 是 仅 仅 是 /proc.实 践 是 最 好 的 策 略 .

缺 省 设 置 : none (也 就 是 说 ,所 有 目 录 的 内 容 会 正 常 的 传 递 给 客 户 端 )

示 例 : dont descend = /proc,/dev

dos charset (G)

DOS SMB clients assume the server has the same charset as they do. This option specifies which charset Samba should talk to DOS clients.

The default depends on which charsets you have installed. Samba tries to use charset 850 but falls back to ASCII in case it is not available. Run testparm(1) to check the default on your system.

dos filemode (S)

The default behavior in Samba is to provide UNIX-like behavior where only the owner of a file/directory is able to change the permissions on it. However, this behavior is often confusing to DOS/Windows users. Enabling this parameter allows a user who has write access to the file (by whatever means) to modify the permissions on it. Note that a user belonging to the group owning the file will not be allowed to change permissions if the group is only granted read access. Ownership of the file/directory is not changed, only the permissions are modified.

缺 省 设 置 : dos filemode = no

dos filetime resolution (S)

在 DOS和 Windows FAT文 件 系 统 中 ,时 间 的 计 量 精 度 是 2秒 。 对 共 享 资 源 设 置 这 个 选 项 ,可 以 使 得 在 一 个 向 smbd(8)的 查 询 需 要 1秒 精 度 时 ， Samba把 报 告 的 时 间 精 度 降 低 到 2秒 左 右 。

这 个 选 项 的 主 要 用 于 解 决 Visual C++与 Samba的 兼 容 性 问 题 .当 共 享 文 件 被 锁 定 时 (oplocks选 项 被 设 置 为 允 许 ),Visual C++使 用 两 个 不 同 的 读 取 时 间 的 函 数 调 用 来 检 查 文 件 自 从 最 后 一 次 读 操 作 以 来 是 否 有 改 变 .其 中 一 个 函 数 使 用 1秒 的 时 间 尺 度 ,而 另 一 个 则 使 用 2秒 的 时 间 尺 度 .由 于 使 用 基 于 2秒 的 方 法 要 舍 去 任 何 的 奇 数 秒 ,当 文 件 的 时 间 记 录 是 奇 数 秒 时 ,Visual C++的 两 次 函 数 调 用 结 果 就 会 不 一 致 ,Visual C++就 会 总 是 认 为 文 件 被 改 变 .设 置 这 个 选 项 可 以 使 得 两 次 函 数 调 用 的 结 果 一 致 ,Visual C++会 很 高 兴 的 接 受 这 一 切 .

缺 省 设 置 : dos filetime resolution = no

dos filetimes (S)

在 DOS和 Windows操 作 系 统 中 ,如 果 用 户 对 文 件 进 行 写 操 作 ,就 会 改 变 文 件 的 时 间 记 录 .而 在 POSIX规 则 中 ,只 有 文 件 的 所 有 者 和 root才 有 改 变 文 件 时 间 记 录 的 能 力 .缺 省 的 ,Samba按 照 POSIX规 则 运 行 ,如 果 smbd的 用 户 不 是 文 件 的 所 有 者 ,那 么 他 对 文 件 的 操 作 不 会 改 变 文 件 的 时 间 记 录 .如 果 设 置 这 个 选 项 为 yes,那 么 smbd(8)就 按 照 DOS的 规 则 运 行 ,并 且 按 照 DOS系 统 的 要 求 改 变 文 件 的 时 间 记 录 .

缺 省 设 置 : dos filetimes = no

enable rid algorithm (G)

This option is used to control whether or not smbd in Samba 3.0 should fallback to the algorithm used by Samba 2.2 to generate user and group RIDs. The longterm development goal is to remove the algorithmic mappings of RIDs altogether, but this has proved to be difficult. This parameter is mainly provided so that developers can turn the algorithm on and off and see what breaks. This parameter should not be disabled by non-developers because certain features in Samba will fail to work without it.

缺 省 设 置 : enable rid algorithm = <yes>

encrypt passwords (G)

这 个 布 尔 型 值 控 制 着 是 否 与 客 户 端 用 加 密 口 令 进 行 交 谈 .注 意 ,NT4.0 SP3 及 以 上 还 有 WINDOWS 98在 缺 省 情 况 下 使 用 加 密 口 令 进 行 交 谈 ,除 非 改 变 了 注 册 表 的 相 应 健 值 .想 要 使 用 加 密 口 令 ,清 参 阅 Samba HOWTO Collection中 的 "User Database" 章 节 。

想 要 使 加 密 口 令 能 正 确 的 工 作 , smbd(8)必 须 能 访 问 本 地 的 smbpasswd(5)文 件 (如 何 正 确 设 置 和 维 护 这 个 文 件 ,请 参 阅 smbpasswd(8)手 册 ),或 者 ,设 置 选 项 security= [server|domain|ads],这 样 设 置 将 使 得 smbd依 赖 其 它 的 服 务 器 来 帮 它 鉴 别 口 令 .

缺 省 设 置 : encrypt passwords = yes

enhanced browsing (G)

This option enables a couple of enhancements to cross-subnet browse propagation that have been added in Samba but which are not standard in Microsoft implementations.

The first enhancement to browse propagation consists of a regular wildcard query to a Samba WINS server for all Domain Master Browsers, followed by a browse synchronization with each of the returned DMBs. The second enhancement consists of a regular randomised browse synchronization with all currently known DMBs.

You may wish to disable this option if you have a problem with empty workgroups not disappearing from browse lists. Due to the restrictions of the browse protocols these enhancements can cause a empty workgroup to stay around forever which can be annoying.

In general you should leave this option enabled as it makes cross-subnet browse propagation much more reliable.

缺 省 设 置 : enhanced browsing = yes

enumports command (G)

The concept of a "port" is fairly foreign to UNIX hosts. Under Windows NT/2000 print servers, a port is associated with a port monitor and generally takes the form of a local port (i.e. LPT1:, COM1:, FILE:) or a remote port (i.e. LPD Port Monitor, etc...). By default, Samba has only one port defined--"Samba Printer Port". Under Windows NT/2000, all printers must have a valid port name. If you wish to have a list of ports displayed (smbd does not use a port name for anything) other than the default "Samba Printer Port", you can define enumports command to point to a program which should generate a list of ports, one per line, to standard output. This listing will then be used in response to the level 1 and 2 EnumPorts() RPC.

缺 省 设 置 : no enumports command

示 例 : enumports command = /usr/bin/listports

exec (S)

与 preexec 同 义 。

fake directory create times (S)

NTFS和 Windows VFAT文 件 系 统 为 每 一 个 文 件 和 目 录 保 留 一 个 创 建 时 间 . 这 个 时 间 和 UNIX下 的 状 态 改 变 时 间 --ctime不 同 . 所 以 , 在 缺 省 状 态 下 , Samba将 报 告 UNIX系 统 所 保 持 的 各 种 时 间 属 性 中 的 最 早 的 那 个 作 为 (文 件 /目 录 )建 立 时 间 . 如 果 在 一 个 共 享 中 设 置 了 这 个 选 项 , 将 会 使 得 Samba伪 造 一 个 目 录 生 成 时 间 , 这 个 时 间 就 是 1980.01.01的 午 夜 .

这 个 选 项 的 主 要 用 于 解 决 Visual C++与 Samba的 兼 容 性 问 题 .Visual C++生 成 makefiles文 件 时 , 包 含 目 标 文 件 所 依 赖 的 目 的 目 录 . 包 含 建 立 目 录 的 规 则 . 同 样 的 , 当 NMAKE比 较 时 间 属 性 时 , 它 检 查 目 录 建 立 时 间 . 目 标 目 录 不 存 在 的 话 , 会 建 立 一 个 ； 如 果 存 在 ,它 的 建 立 时 间 总 是 比 它 所 包 含 的 目 标 文 件 的 建 立 时 间 早 .

UNIX的 时 间 规 则 意 味 着 只 要 有 文 件 在 共 享 目 录 中 建 立 或 删 除 ,Samba将 更 新 关 于 该 目 录 建 立 时 间 的 报 告 . NMAKE将 发 现 目 录 中 除 了 最 后 建 立 的 文 件 以 外 的 所 有 目 标 文 件 都 过 期 了 (与 目 录 的 建 立 时 间 相 比 较 ), 然 后 重 新 编 译 目 标 文 件 .设 置 这 个 选 项 值 将 保 证 目 录 的 建 立 时 间 早 于 它 里 面 的 文 件 ,NMAKE就 能 够 正 常 工 作 .

缺 省 设 置 : fake directory create times = no

fake oplocks (S)

oplocks是 这 样 一 个 选 项 , 它 允 许 SMB客 户 端 在 本 地 缓 存 对 服 务 器 的 文 件 操 作 . 如 果 服 务 器 允 许 oplock(opportunistic lock)操 作 , 客 户 端 可 以 简 单 的 认 为 , 它 自 己 是 唯 一 的 文 件 访 问 者 , 可 以 随 意 的 缓 存 文 件 . 有 些 oplocks类 型 甚 至 允 许 缓 存 文 件 的 打 开 和 关 闭 操 作 . 这 个 操 作 换 来 性 能 上 的 巨 大 提 升 .

当 你 设 置 fake oplocks = yes后 ,smbd(8)总 是 允 许 oplock请 求 , 而 不 管 到 底 有 多 少 的 客 户 端 在 使 用 这 个 文 件 .

在 通 常 情 况 下 , 使 用 真 实 的 oplocks支 持 总 是 比 使 用 这 个 选 项 好 .

如 果 你 使 用 这 个 选 项 在 一 些 只 读 的 共 享 上 (例 如 : CDROM共 享 ),或 者 你 知 道 这 个 共 享 只 能 够 被 一 个 客 户 端 所 访 问 (例 如 : 客 户 主 目 录 ). 你 将 会 注 意 到 性 能 上 的 重 大 提 升 . 如 果 你 将 这 个 选 项 用 在 多 个 客 户 端 都 可 以 读 写 的 共 享 上 , 由 于 客 户 可 能 同 时 访 问 一 个 共 享 文 件 , 这 样 会 造 成 文 件 损 坏 . 请 一 定 小 心 使 用 .

缺 省 设 置 : fake oplocks = no

follow symlinks (S)

这 个 选 项 允 许 Samba管 理 员 禁 止 某 个 特 殊 共 享 下 smbd(8)对 符 号 链 接 的 访 问 . 将 这 个 选 项 设 置 为 no将 会 阻 止 这 个 共 享 下 的 任 何 链 接 形 式 的 文 件 或 目 录 被 查 看 (用 户 将 会 得 到 一 个 错 误 信 息 ).例 如 : 这 个 选 项 将 阻 止 客 户 将 /etc/passwd文 件 链 接 到 自 己 的 主 目 录 . (我 们 看 到 , 这 是 很 有 用 的 ). 但 是 , 它 将 会 使 文 件 名 字 的 查 找 速 度 慢 一 些 .

这 个 选 项 缺 省 是 允 许 (也 就 是 , smbd将 允 许 访 问 符 号 链 接 )

缺 省 设 置 : follow symlinks = yes

force create mode (S)

这 个 选 项 设 置 一 组 UNIX格 式 的 权 限 代 码 , 当 Samba建 立 新 文 档 的 时 候 , 总 是 会 使 用 这 个 权 限 设 置 新 文 档 , 通 过 将 新 文 档 的 权 限 位 和 这 组 权 限 代 码 做 逐 位 与 , 就 完 成 了 设 置 工 作 .缺 省 状 态 下 , 这 个 选 项 设 置 为 八 进 制 000,在 create mask加 到 新 建 立 的 文 件 的 权 限 位 上 后 , 与 这 个 值 进 行 按 位 与 操 作 , 就 得 到 文 件 建 立 时 的 权 限 设 置 .

参 见 create mask 来 获 得 关 于 建 立 文 件 时 的 掩 码 的 详 细 资 料 。

另 外 也 参 见 inherit permissions 参 数 .

缺 省 设 置 : force create mode = 000

示 例 : force create mode = 0755

这 个 例 子 中 , 将 迫 使 所 有 被 建 立 的 文 档 对 "同 组 /其 它 (用 户 )"有 读 和 执 行 权 . 对 用 户 自 己 有 读 /写 /执 行 权 力 .

force directory mode (S)

这 个 选 项 设 置 一 组 UNIX格 式 的 权 限 代 码 , 当 Samba建 立 新 目 录 的 时 候 , 总 是 会 使 用 这 个 权 限 设 置 新 目 录 , 通 过 将 新 目 录 的 权 限 位 和 这 组 权 限 代 码 做 逐 位 与 , 就 完 成 了 设 置 工 作 .缺 省 状 态 下 , 这 个 选 项 设 置 为 八 进 制 000,在 directory mask加 到 新 建 立 的 目 录 的 权 限 位 上 后 ,与 这 个 值 进 行 按 位 与 操 作 , 就 得 到 目 录 建 立 时 的 权 限 设 置 .

参 见 directory mask 来 获 得 关 于 建 立 目 录 时 的 掩 码 的 详 细 资 料 。

另 外 也 参 见 inherit permissions参 数 .

缺 省 设 置 : force directory mode = 000

示 例 : force directory mode = 0755

这 个 例 子 中 , 将 迫 使 所 有 被 建 立 的 目 录 对 "同 组 /其 它 (用 户 )"有 读 和 进 入 权 . 对 用 户 自 己 有 读 /写 /进 入 权 力 .

force directory security mode (S)

此 选 项 控 制 NT用 户 通 过 本 地 NT安 全 对 话 框 可 以 操 作 哪 些 目 录 上 的 unix权 限 位 .

此 选 项 以 掩 码 (’or’)来 实 现 权 限 位 的 改 变 ,所 以 它 强 制 了 任 何 掩 码 中 用 户 可 以 更 改 的 位 .实 际 上 ,当 在 修 改 目 录 的 安 全 性 时 ,这 个 掩 码 中 的 一 个 0位 可 以 作 为 一 组 用 户 已 经 设 为 ’on’的 位 来 看 待 .

如 果 没 有 明 确 设 定 的 话 ,这 个 选 项 会 用 与 force directory mode选 项 同 样 的 值 .要 允 许 用 户 在 目 录 中 可 以 修 改 所 有 的 user/group/world权 限 ,可 以 把 这 个 选 项 设 为 0000.

注 意 ,能 访 问 samba服 务 器 的 用 户 通 过 其 它 方 法 也 可 以 很 容 易 地 绕 过 这 个 限 制 ,所 以 这 个 参 数 只 对 独 立 工 作 的 应 用 系 统 来 说 有 用 .很 多 系 统 管 理 的 管 理 员 都 会 把 它 设 为 默 认 的 0000.

参 见 directory security mask, security mask, force security mode 参 数 。

缺 省 设 置 : force directory security mode = 0

示 例 : force directory security mode = 700

force group (S)

这 个 选 项 指 定 一 个 UNIX组 , 所 有 连 接 到 服 务 上 的 用 户 都 被 强 迫 使 用 这 个 组 作 为 "主 组 ". 所 有 访 问 文 件 的 用 户 都 使 用 这 个 组 的 访 问 权 限 做 权 限 检 查 . 因 此 , 通 过 分 配 文 件 和 目 录 的 访 问 权 限 给 这 个 用 户 组 , Samba的 管 理 员 可 以 限 制 或 允 许 对 共 享 文 件 的 访 问 .

在 samba 2.0.5及 更 新 的 版 本 中 这 个 选 项 已 经 按 下 面 的 方 法 有 了 一 些 扩 展 功 能 .如 果 在 此 列 出 的 组 名 有 一 个 ’+’字 符 加 在 名 称 前 的 话 ,当 前 用 户 正 在 访 问 的 共 享 资 源 只 有 初 始 组 被 缺 省 分 配 到 这 个 组 中 ,而 可 能 的 情 况 是 用 户 已 经 是 其 它 组 成 员 了 .这 样 ,管 理 员 可 以 决 定 只 有 在 特 殊 组 里 的 用 户 才 能 以 设 定 的 组 身 份 建 立 文 件 ,更 有 益 于 所 有 权 分 配 管 理 .例 如 ,设 定 force group = +sys的 话 ,只 有 在 sys组 里 的 用 户 才 能 在 访 问 samba共 享 资 源 时 拥 有 缺 省 的 初 始 组 标 识 .而 其 它 所 有 用 户 保 留 他 们 原 始 的 组 标 识 .

如 果 又 设 定 了 force user选 项 的 话 ,force group选 项 中 指 定 的 组 将 会 越 过 在 force user中 指 定 的 初 始 组 . If the force user parameter is also set the group specified in force group will override the primary group set in force user.

参 见 force user选 项 .

缺 省 设 置 : no forced group

示 例 : force group = agroup

force security mode (S)

此 选 项 控 制 NT用 户 通 过 本 地 NT安 全 对 话 框 可 以 操 作 哪 些 目 录 上 的 unix权 限 位 .

此 选 项 以 掩 码 (’or’)来 实 现 权 限 位 的 改 变 ,所 以 它 强 制 了 任 何 掩 码 中 用 户 可 以 更 改 的 位 .实 际 上 ,当 在 修 改 目 录 的 安 全 性 时 ,这 个 掩 码 中 的 一 个 0位 可 以 作 为 一 组 用 户 已 经 设 为 ’on’的 位 来 看 待 .

如 果 没 有 明 确 设 定 的 话 ,这 个 选 项 会 用 与 force create mode选 项 同 样 的 值 .要 允 许 用 户 在 文 件 上 可 以 修 改 所 有 的 user/group/world权 限 ,可 以 把 这 个 选 项 设 为 000.

注 意 ,能 访 问 samba服 务 器 的 用 户 通 过 其 它 方 法 可 以 很 容 易 地 绕 过 这 个 限 制 ,所 以 这 个 选 项 对 独 立 工 作 的 系 统 来 说 才 有 用 的 .很 多 系 统 管 理 的 管 理 员 都 会 把 它 设 为 默 认 的 0000.

参 见 force directory security mode, directory security mask, security mask 参 数 。

缺 省 设 置 : force security mode = 0

示 例 : force security mode = 700

force user (S)

这 个 选 项 指 定 一 个 UNIX用 户 的 名 字 , 所 有 连 接 到 服 务 上 的 用 户 的 缺 省 名 字 就 使 用 这 个 名 字 . (由 于 权 限 的 原 因 )在 共 享 文 件 时 这 个 选 项 是 有 用 的 .你 必 须 小 心 使 用 这 个 选 项 , 它 有 可 能 带 来 安 全 上 的 问 题 .

这 个 选 项 只 有 当 一 个 连 接 建 立 起 来 后 才 有 用 . 在 建 立 连 接 的 使 用 , 用 户 还 是 必 须 有 合 法 的 用 户 名 和 口 令 . 一 旦 连 接 建 立 起 来 , 所 有 的 操 作 将 强 迫 以 这 个 名 字 进 行 , 而 不 管 它 是 以 什 么 名 字 登 录 的 .

samba 2.0.5和 更 新 的 版 本 中 这 个 选 项 会 导 致 用 户 的 初 始 组 被 作 为 所 有 文 件 操 作 的 初 始 组 .2.0.5以 前 的 初 始 组 被 允 许 作 为 联 接 用 户 的 初 始 组 (这 是 个 bug)

参 见 force group 选 项 。

缺 省 设 置 : no forced user

示 例 : force user = auser

fstype (S)

这 个 选 项 允 许 管 理 员 设 置 一 个 字 符 串 说 明 共 享 的 文 件 系 统 的 类 型 , 当 客 户 端 有 查 询 时 , smbd(8)将 这 个 字 符 串 作 为 正 在 使 用 的 文 件 系 统 的 类 型 报 告 给 客 户 端 . 为 了 和 Windows NT兼 容 缺 省 值 设 置 是 NTFS, 当 然 ,如 果 必 要 的 话 ,也 可 以 改 变 为 其 它 的 字 符 串 ,例 如 Samba或 FAT.

缺 省 设 置 : fstype = NTFS

示 例 : fstype = Samba

get quota command (G)

The get quota command should only be used whenever there is no operating system API available from the OS that samba can use.

This parameter should specify the path to a script that queries the quota information for the specified user/group for the partition that the specified directory is on.

Such a script should take 3 arguments:

directory

type of query

uid of user or gid of group

The type of query can be one of :

1 - user quotas

2 - user default quotas (uid = -1)

3 - group quotas

4 - group default quotas (gid = -1)

This script should print its output according to the following format:

Line 1 - quota flags (0 = no quotas, 1 = quotas enabled, 2 = quotas enabled and enforced)

Line 2 - number of currently used blocks

Line 3 - the softlimit number of blocks

Line 4 - the hardlimit number of blocks

Line 5 - currently used number of inodes

Line 6 - the softlimit number of inodes

Line 7 - the hardlimit number of inodes

Line 8(optional) - the number of bytes in a block(default is 1024)

参 见 set quota command 选 项 。

缺 省 设 置 : get quota command =

示 例 : get quota command = /usr/local/sbin/query_quota

getwd cache (G)

这 是 一 个 性 能 调 节 选 项 . 当 这 个 选 项 允 许 时 , 一 个 高 速 缓 冲 算 法 将 被 用 来 减 少 调 用 "getwd()"的 时 间 . 这 个 选 项 对 性 能 会 产 生 很 大 的 影 响 , 特 别 是 在 wide links选 项 设 为 no的 时 候 .

缺 省 设 置 : getwd cache = yes

group (S)

与 force group 同 义 。

guest account (G,S)

这 是 一 个 用 来 访 问 服 务 的 用 户 名 (作 为 客 户 来 访 账 户 ,区 别 于 系 统 上 的 用 户 ), 当 然 , 被 访 问 的 服 务 必 须 先 设 置 了 选 项 fI guest ok. 这 个 账 户 所 拥 有 的 所 有 权 利 都 会 反 映 到 以 "访 问 客 户 (guest)"身 份 连 接 进 来 的 客 户 身 上 . 典 型 的 , 这 个 客 户 必 须 在 passwd文 件 中 存 在 , 但 是 没 有 有 效 的 登 录 权 限 .通 常 系 统 中 存 在 着 名 为 "ftp"的 账 户 ,把 这 个 账 户 名 使 用 在 这 里 是 个 好 主 意 .注 意 :如 果 一 个 服 务 指 定 了 一 个 专 用 的 访 问 用 户 名 ,这 个 专 用 名 将 代 替 这 里 的 用 户 名 .

在 某 些 系 统 上 ,缺 省 的 访 问 用 户 名 "nobody"账 户 可 能 不 能 打 印 .如 果 遇 到 这 种 情 况 ,请 使 用 其 它 的 账 户 名 (例 如 ftp)。 想 要 测 试 这 种 情 况 ,可 以 试 着 用 来 访 账 户 登 录 (可 以 用 su -命 令 ),然 后 ,使 用 系 统 打 印 命 令 lpr(1)或 lp(1).

这 个 参 数 不 接 受 %宏 ， 因 为 Samba系 统 的 很 多 组 件 要 正 确 工 作 都 需 要 这 个 值 是 一 个 常 量 。

缺 省 设 置 : 编 译 时 指 定 ， 通 常 是 "nobody"

示 例 : guest account = ftp

guest ok (S)

如 果 一 个 服 务 的 这 个 选 项 的 值 设 为 yes, 那 末 , 连 接 到 这 个 服 务 不 需 要 口 令 , 权 限 设 置 为 guest account的 权 限 .

这 个 选 项 抵 消 了 设 置 restrict anonymous = 2 的 好 处 。

参 见 下 面 的 security来 获 得 更 多 信 息 。

缺 省 设 置 : guest ok = no

guest only (S)

如 果 一 个 服 务 的 这 个 选 项 设 置 为 yes, 那 末 , 只 有 客 户 (guest)访 问 被 允 许 , 也 就 是 说 , 不 允 许 以 其 他 用 户 的 身 份 访 问 .如 果 没 有 设 置 guest ok选 项 , 则 此 选 项 无 效 .

参 见 下 面 的 security 参 数 来 获 得 更 多 信 息 。

缺 省 设 置 : guest only = no

hide dot files (S)

这 是 一 个 布 尔 值 选 项 . 控 制 文 件 名 最 前 面 一 个 字 符 为 "."的 文 件 是 否 表 现 为 隐 含 文 件 (UNIX文 件 系 统 中 , 最 前 面 为 "."的 文 件 是 隐 含 文 件 ).

缺 省 设 置 : hide dot files = yes

hide files (S)

这 是 一 个 隐 藏 文 件 或 目 录 的 列 表 .这 些 文 件 不 能 被 看 见 但 是 能 被 访 问 .列 表 中 的 文 件 或 目 录 将 被 赋 予 DOS下 的 "隐 藏 "属 性 .

每 个 条 目 必 须 以 "/"分 隔 以 便 允 许 在 条 目 中 使 用 空 格 .可 以 使 用 DOS风 格 的 通 配 符 "*"和 "?"匹 配 多 个 目 录 和 文 件 。

每 一 个 条 目 必 须 使 用 UNIX格 式 的 路 径 ,而 不 是 DOS格 式 的 路 径 ,同 时 ,不 能 包 含 UNIX路 径 分 隔 符 "/".

注 意 :大 小 写 敏 感 的 特 性 也 适 用 于 隐 含 文 件 .

设 置 这 个 选 项 会 影 响 Samba的 性 能 ,它 会 迫 使 系 统 检 查 所 有 的 文 件 和 目 录 以 确 定 是 否 与 它 的 所 要 寻 找 的 项 目 匹 配 .

参 见 hide dot files, veto files 和 case sensitive.

缺 省 设 置 : 没 有 隐 藏 文 件

示 例 : hide files = /.*/DesktopFolderDB/TrashFor%m/resource.frk/

上 面 的 例 子 中 的 文 件 从 Thursby共 享 出 来 ,给 Macintosh的 SMB客 户 端 (DAVE),供 内 部 使 用 ,仍 然 隐 藏 了 "."打 头 的 文 件 .

hide local users (G)

This parameter toggles the hiding of local UNIX users (root, wheel, floppy, etc) from remote clients.

缺 省 设 置 : hide local users = no

hide special files (S)

This parameter prevents clients from seeing special files such as sockets, devices and fifo’s in directory listings.

缺 省 设 置 : hide special files = no

hide unreadable (S)

This parameter prevents clients from seeing the existance of files that cannot be read. Defaults to off.

缺 省 设 置 : hide unreadable = no

hide unwriteable files (S)

This parameter prevents clients from seeing the existance of files that cannot be written to. Defaults to off. Note that unwriteable directories are shown as usual.

缺 省 设 置 : hide unwriteable = no

homedir map (G)

如 果 nis homedir 选 项 的 值 为 yes,同 时 , smbd(8)也 作 为 win95/98的 登 录 服 务 器 ,那 么 ,这 个 选 项 指 明 一 个 NIS(或 者 YP)映 射 .指 向 用 户 主 目 录 所 在 的 服 务 器 .目 前 ,只 认 识 Sun的 auto.home映 射 格 式 .映 射 格 式 如 下 :

username server:/some/file/system

程 序 从 ":"号 前 取 得 服 务 器 名 字 .将 来 也 许 会 有 更 好 的 解 释 系 统 来 处 理 不 同 的 映 射 格 式 ,当 然 ,也 包 括 Amd(另 一 种 自 动 装 载 方 式 )映 射 .

需 要 系 统 中 有 一 个 运 行 的 NIS客 户 来 使 这 个 选 项 工 作 。

参 见 nis homedir , domain logons .

缺 省 设 置 : homedir map = <空 字 符 串 >

示 例 : homedir map = amd.homedir

host msdfs (G)

If set to yes, Samba will act as a Dfs server, and allow Dfs-aware clients to browse Dfs trees hosted on the server.

参 见 msdfs root share level 选 项 。 For more information on setting up a Dfs tree on Samba, refer to ???.

缺 省 设 置 : host msdfs = no

hostname lookups (G)

Specifies whether samba should use (expensive) hostname lookups or use the ip addresses instead. An example place where hostname lookups are currently used is when checking the hosts deny and hosts allow.

缺 省 设 置 : hostname lookups = yes

示 例 : hostname lookups = no

hosts allow (S)

与 allow hosts 同 义 .

这 个 选 项 是 一 个 由 逗 号 ,空 格 或 者 tab字 符 隔 开 的 一 组 主 机 名 .列 入 其 中 的 主 机 才 允 许 访 问 .

如 果 该 选 项 出 现 在 [global]段 中 ,它 会 作 用 于 所 有 服 务 而 忽 略 单 个 服 务 所 作 的 不 同 设 置 .

你 可 以 用 ip地 址 或 主 机 名 来 指 定 主 机 .比 如 ,你 可 以 用 类 似 allow hosts = 150.203.5. 来 限 定 只 允 许 访 问 在 这 个 c类 子 网 中 的 主 机 .hosts_access(5)中 详 细 描 述 了 关 于 这 个 选 项 设 置 的 完 整 语 法 .注 意 到 你 的 系 统 中 也 许 没 有 这 个 参 考 手 册 ,这 里 也 作 一 个 简 单 的 说 明 .

注 意 ， 本 机 地 址 127.0.0.1 总 是 允 许 连 接 ,除 非 在 hosts deny 选 项 中 加 以 禁 止 .

你 也 可 以 使 用 子 网 号 /子 网 掩 码 对 来 指 定 主 机 .如 果 你 的 网 络 支 持 网 络 组 ,你 还 可 以 用 网 络 组 名 来 指 定 组 内 的 主 机 .EXCEPT(除 了 ...)关 键 字 可 以 在 使 用 了 通 配 符 的 情 况 下 起 到 限 定 作 用 .

Example 1: 允 许 150.203.*.* 中 除 了 一 台 机 器 之 外 的 所 有 IP访 问

hosts allow = 150.203. EXCEPT 150.203.6.66

Example 2: 允 许 满 足 给 定 的 子 网 号 /子 网 掩 码 的 IP访 问

hosts allow = 150.203.15.0/255.255.255.0

Example 3: 允 许 一 系 列 主 机 访 问

hosts allow = lapland, arvidsjaur

Example 4: 允 许 NIS网 络 组 "foonet"访 问 ,但 是 禁 止 其 中 的 一 台 主 机

hosts allow = @foonet

hosts deny = pirate

注 意 ,访 问 时 还 是 需 要 有 适 当 的 用 户 级 口 令 .

参 见 testparm(1) 来 检 测 主 机 是 否 可 以 按 照 你 希 望 的 方 式 被 访 问 .

缺 省 设 置 : none (也 就 是 说 ,所 有 机 器 都 可 以 访 问 )

示 例 : allow hosts = 150.203.5. myhost.mynet.edu.au

hosts deny (S)

hosts allow选 项 的 反 义 词 .所 有 被 列 入 这 个 选 项 中 的 主 机 的 服 务 都 不 允 许 被 访 问 ,除 非 这 个 被 访 问 的 服 务 定 义 了 自 己 的 允 许 列 表 .当 允 许 的 主 机 列 表 和 禁 止 的 主 机 列 表 发 生 冲 突 的 时 候 ,allow优 先 .

缺 省 设 置 : none (没 有 禁 止 访 问 的 主 机 )

示 例 : hosts deny = 150.203.4. badhost.mynet.edu.au

hosts equiv (G)

如 果 这 个 选 项 值 不 是 空 字 符 串 ,就 指 定 了 一 个 文 件 名 .这 个 文 件 中 列 出 了 可 以 不 用 口 令 就 允 许 访 问 的 主 机 和 用 户 的 名 字 .

不 要 把 这 个 选 项 和 hosts allow 搞 混 了 ,那 是 关 于 控 制 主 机 对 服 务 的 访 问 的 ,用 于 管 理 对 来 访 者 的 服 务 .而 hosts equiv是 用 于 支 持 那 些 不 对 samba提 供 口 令 的 NT客 户 的 .

注 意 :使 用 hosts equiv 可 能 会 成 为 一 个 很 大 的 安 全 漏 洞 .这 是 因 为 你 相 信 发 起 访 问 的 PC提 供 了 正 确 的 用 户 名 .找 一 台 PC来 提 供 一 个 假 的 用 户 名 是 很 容 易 的 .我 建 议 你 只 有 在 完 全 明 白 你 在 干 什 么 的 情 况 下 才 使 用 hosts equiv选 项 ,或 者 在 你 自 己 的 家 里 (那 里 有 你 可 以 完 全 信 任 的 配 偶 和 孩 子 )使 用 它 .仅 仅 是 在 你 完 全 可 以 信 任 他 们 的 时 候 才 用 :-)

缺 省 设 置 : no host equivalences

示 例 : hosts equiv = /etc/hosts.equiv

idmap backend (G)

The purpose of the idmap backend parameter is to allow idmap to NOT use the local idmap tdb file to obtain SID to UID / GID mappings, but instead to obtain them from a common LDAP backend. This way all domain members and controllers will have the same UID and GID to SID mappings. This avoids the risk of UID / GID inconsistencies across UNIX / Linux systems that are sharing information over protocols other than SMB/CIFS (ie: NFS).

缺 省 设 置 : idmap backend = <空 字 符 串 >

示 例 : idmap backend = ldap:ldap://ldapslave.example.com

idmap gid (G)

The idmap gid parameter specifies the range of group ids that are allocated for the purpose of mapping UNX groups to NT group SIDs. This range of group ids should have no existing local or NIS groups within it as strange conflicts can occur otherwise.

The availability of an idmap gid range is essential for correct operation of all group mapping.

缺 省 设 置 : idmap gid = <空 字 符 串 >

示 例 : idmap gid = 10000-20000

idmap uid (G)

The idmap uid parameter specifies the range of user ids that are allocated for use in mapping UNIX users to NT user SIDs. This range of ids should have no existing local or NIS users within it as strange conflicts can occur otherwise.

缺 省 设 置 : idmap uid = <空 字 符 串 >

示 例 : idmap uid = 10000-20000

include (G)

这 个 选 项 使 得 你 可 以 把 一 个 配 置 文 件 插 入 到 另 一 个 配 置 文 件 中 去 .这 只 是 一 种 文 本 替 换 ,就 在 好 像 被 插 入 的 文 件 的 那 个 位 置 直 接 写 入 那 个 插 入 文 件 一 样 .

它 支 持 标 准 替 换 ,除 %u , %P 和 %S以 外 .

缺 省 设 置 : 没 有 包 含 其 他 文 件

示 例 : include = /usr/local/samba/lib/admin_smb.conf

inherit acls (S)

This parameter can be used to ensure that if default acls exist on parent directories, they are always honored when creating a subdirectory. The default behavior is to use the mode specified when creating the directory. Enabling this option sets the mode to 0777, thus guaranteeing that default directory acls are propagated.

缺 省 设 置 : inherit acls = no

inherit permissions (S)

The permissions on new files and directories are normally governed by create mask, directory mask, force create mode and force directory mode but the boolean inherit permissions parameter overrides this.

New directories inherit the mode of the parent directory, including bits such as setgid.

New files inherit their read/write bits from the parent directory. Their execute bits continue to be determined by map archive , map hidden and map system as usual.

Note that the setuid bit is never set via inheritance (the code explicitly prohibits this).

This can be particularly useful on large systems with many users, perhaps several thousand, to allow a single [homes] share to be used flexibly by each user.

参 见 create mask , directory mask, force create mode and force directory mode .

缺 省 设 置 : inherit permissions = no

interfaces (G)

这 个 选 项 允 许 你 超 越 默 认 的 Samba用 来 处 理 浏 览 ,名 字 注 册 和 其 他 NBT网 络 流 量 的 网 络 借 口 列 表 . 默 认 情 况 Samba向 内 核 查 询 所 有 活 动 的 接 口 列 表 并 且 使 用 除 了 127.0.0.1 之 外 的 接 口 .

这 个 选 项 的 内 容 是 一 个 接 口 字 符 串 的 列 表 , 每 个 字 符 串 可 以 是 下 列 任 何 一 种 格 式 :

一 个 网 络 接 口 名 (例 如 eth0).它 可 以 包 含 象 在 shell风 格 的 通 配 符 如 eth*来 匹 配 任 何 以 子 字 符 品 "eth"起 始 的 网 络 接 口 .

一 个 IP地 址 .这 种 情 况 下 ,网 络 掩 码 是 从 内 核 中 获 得 的 接 口 列 表 中 检 测 的 .

一 个 IP/掩 码 对 .

一 个 广 播 地 址 /掩 码 对 .

"mask"选 项 可 以 是 一 个 位 长 度 (例 如 C类 网 络 可 以 是 24)或 者 是 以 点 分 格 式 出 现 的 完 整 网 络 地 址 掩 码 .

"IP"选 项 可 以 是 完 整 点 分 十 六 进 制 IP地 址 或 是 按 操 作 系 统 通 常 使 用 的 主 机 名 解 析 机 制 查 找 的 主 机 名 .

例 如 ,下 面 这 一 行 :

interfaces = eth0 192.168.2.10/24 192.168.3.10/255.255.255.0

将 配 置 三 个 网 络 接 口 ,对 应 eth0设 备 以 及 IP地 址 192.168.2.10 和 192.168.3.10。 后 两 个 接 口 的 网 络 掩 码 将 设 置 为 255.255.255.0。

参 见 bind interfaces only.

缺 省 设 置 : 除 了 127.0.0.1 之 外 的 所 有 活 动 接 口 that are broadcast capable

invalid users (S)

这 是 一 个 不 允 许 在 这 个 服 务 上 登 录 的 用 户 的 名 单 .这 的 确 是 一 个 非 常 严 格 的 (paranoid)检 查 ,确 保 任 何 可 能 的 不 适 当 的 设 置 都 不 会 破 坏 你 的 系 统 的 安 全 .

以 @开 头 的 用 户 名 首 先 被 当 作 NIS网 络 组 名 (如 果 你 的 系 统 支 持 NIS的 话 ),如 果 在 NIS的 网 络 组 数 据 库 中 找 不 到 这 个 组 ,那 么 这 个 名 字 就 被 当 作 一 个 UNIX用 户 组 名 来 处 理 .

以 +开 头 的 用 户 名 仅 表 示 UNIX用 户 组 名 ,以 &开 头 的 用 户 名 仅 表 示 NIX网 络 组 名 (这 个 设 置 要 求 你 的 系 统 中 有 NIS在 运 行 ).’+’和 ’&’符 号 可 以 以 任 何 顺 序 出 现 在 用 户 组 名 前 ,因 此 ,你 可 以 指 定 对 这 个 名 称 的 查 找 次 序 ,比 如 +&group表 示 先 在 UNIX用 户 组 中 查 找 ,再 在 NIS网 络 组 中 查 找 ,而 &+group则 相 反 ,先 在 NIX网 络 组 中 查 找 ,再 到 UNIX用 户 组 中 查 找 .(这 与 使 用 @前 缀 的 效 果 相 同 ).

当 前 的 服 务 名 可 以 用 %S来 表 示 ,这 在 [homes]段 中 是 很 有 用 的 .

参 见 valid users .

缺 省 设 置 : 没 有 非 法 用 户

示 例 : invalid users = root fred admin @wheel

keepalive (G)

这 个 选 项 是 一 个 整 数 ,它 表 示 用 于 keepalive包 间 隔 的 秒 数 .如 果 这 个 选 项 是 0,那 么 就 不 发 送 保 持 连 接 的 包 .发 送 保 持 连 接 的 包 使 得 主 机 可 以 确 定 客 户 端 是 否 还 在 响 应 。

通 常 ,如 果 用 于 连 接 的 socket使 用 了 SO_KEEPALIVE属 性 设 置 (参 见 socket options),那 么 发 送 保 持 连 接 的 包 是 不 需 要 的 .基 本 上 ,除 非 你 遇 到 了 某 些 困 难 ,这 个 选 项 是 用 不 到 的 .

缺 省 设 置 : keepalive = 300

示 例 : keepalive = 600

kernel change notify (G)

This parameter specifies whether Samba should ask the kernel for change notifications in directories so that SMB clients can refresh whenever the data on the server changes.

This parameter is only usd when your kernel supports change notification to user programs, using the F_NOTIFY fcntl.

缺 省 设 置 : Yes

kernel oplocks (G)

在 支 持 基 于 内 核 的 oplocks(opportunistic lock)的 UNIX系 统 上 (目 前 只 有 IRIX 和 Linux2.4内 核 ),这 个 选 项 允 许 打 开 或 关 闭 对 这 个 特 性 的 利 用 .

内 核 机 会 性 锁 定 操 作 使 得 本 地 UNIX进 程 或 NFS对 文 件 进 行 操 作 时 可 以 锁 定 (冻 结 )smbd(8)对 同 一 个 文 件 的 oplocks 操 作 .这 可 以 保 持 SMB/CIFS,NFS和 本 地 文 件 操 作 之 间 的 数 据 一 致 性 .(这 是 一 个 很 cool的 特 性 哦 :-)

如 果 你 的 系 统 支 持 这 个 设 置 ,缺 省 设 置 就 是 on(打 开 ),如 果 系 统 不 支 持 ,缺 省 设 置 就 是 Off(关 闭 ).你 根 本 不 必 去 管 这 个 选 项 .

参 见 oplocks 和 level2 oplocks 参 数 .

缺 省 设 置 : kernel oplocks = yes

lanman auth (G)

This parameter determines whether or not smbd(8) will attempt to authenticate users using the LANMAN password hash. If disabled, only clients which support NT password hashes (e.g. Windows NT/2000 clients, smbclient, etc... but not Windows 95/98 or the MS DOS network client) will be able to connect to the Samba host.

The LANMAN encrypted response is easily broken, due to it’s case-insensitive nature, and the choice of algorithm. Servers without Windows 95/98 or MS DOS clients are advised to disable this option.

Unlike the encypt passwords option, this parameter cannot alter client behaviour, and the LANMAN response will still be sent over the network. See the client lanman auth to disable this for Samba’s clients (such as smbclient)

If this option, and ntlm auth are both disabled, then only NTLMv2 logins will be permited. Not all clients support NTLMv2, and most will require special configuration to us it.

Default : lanman auth = yes

large readwrite (G)

This parameter determines whether or not smbd(8) supports the new 64k streaming read and write varient SMB requests introduced with Windows 2000. Note that due to Windows 2000 client redirector bugs this requires Samba to be running on a 64-bit capable operating system such as IRIX, Solaris or a Linux 2.4 kernel. Can improve performance by 10% with Windows 2000 clients. Defaults to on. Not as tested as some other Samba code paths.

缺 省 设 置 : large readwrite = yes

ldap admin dn (G)

The ldap admin dn defines the Distinguished Name (DN) name used by Samba to contact the ldap server when retreiving user account information. The ldap admin dn is used in conjunction with the admin dn password stored in the private/secrets.tdb file. See the smbpasswd(8) man page for more information on how to accmplish this.

ldap delete dn (G)

This parameter specifies whether a delete operation in the ldapsam deletes the complete entry or only the attributes specific to Samba.

缺 省 设 置 : ldap delete dn = no

ldap filter (G)

这 个 选 项 指 定 了 RFC2254兼 容 的 LDAP搜 索 过 滤 器 。 默 认 对 所 有 匹 配 sambaAccount对 象 类 的 条 目 进 行 登 录 名 和 uid 属 性 之 间 的 匹 配 。 注 意 这 个 过 滤 器 只 应 当 返 回 一 个 条 目 .

缺 省 设 置 : ldap filter = (&(uid=%u)(objectclass=sambaAccount))

ldap group suffix (G)

This parameters specifies the suffix that is used for groups when these are added to the LDAP directory. If this parameter is unset, the value of ldap suffix will be used instead.

缺 省 设 置 : none

示 例 : dc=samba,ou=Groups

ldap idmap suffix (G)

This parameters specifies the suffix that is used when storing idmap mappings. If this parameter is unset, the value of ldap suffix will be used instead.

缺 省 设 置 : none

示 例 : ou=Idmap,dc=samba,dc=org

ldap machine suffix (G)

It specifies where machines should be added to the ldap tree.

缺 省 设 置 : none

ldap passwd sync (G)

This option is used to define whether or not Samba should sync the LDAP password with the NT and LM hashes for normal accounts (NOT for workstation, server or domain trusts) on a password change via SAMBA.

The ldap passwd sync can be set to one of three values:

Yes = Try to update the LDAP, NT and LM passwords and update the pwdLastSet time.

No = Update NT and LM passwords and update the pwdLastSet time.

Only = Only update the LDAP password and let the LDAP server do the rest.

缺 省 设 置 : ldap passwd sync = no

ldap port (G)

这 个 选 项 只 有 在 编 译 时 配 置 了 "--with-ldap"选 项 的 情 况 下 才 可 用 .

这 个 选 项 控 制 用 于 和 LDAP服 务 器 通 讯 的 tcp端 口 号 。 默 认 应 用 标 准 的 LDAP端 口 636。

参 见 : ldap ssl

Default : ldap port = 636 ; 如 果 ldap ssl = on

Default : ldap port = 389 ; 如 果 ldap ssl = off

ldap server (G)

这 个 选 项 只 有 在 编 译 时 配 置 了 "--with-ldapsam"选 项 的 情 况 下 才 可 用 .

这 个 选 项 应 当 包 含 ldap目 录 服 务 器 的 FQDN， 用 来 查 询 和 定 位 用 户 帐 户 信 息 。

Default : ldap server = localhost

ldap ssl (G)

This option is used to define whether or not Samba should use SSL when connecting to the ldap server This is NOT related to Samba’s previous SSL support which was enabled by specifying the --with-ssl option to the configure script.

The ldap ssl can be set to one of three values:

Off = Never use SSL when querying the directory.

Start_tls = Use the LDAPv3 StartTLS extended operation (RFC2830) for communicating with the directory server.

On = Use SSL on the ldaps port when contacting the ldap server. Only available when the backwards-compatiblity --with-ldapsam option is specified to configure. See passdb backend

Default : ldap ssl = start_tls

ldap suffix (G)

指 定 用 户 和 机 器 帐 号 从 哪 里 加 入 树 中 。 可 以 被 ldap user suffix和 ldap machine suffix选 项 越 过 。 它 也 用 作 所 有 ldap搜 索 的 base dn。

缺 省 设 置 : none

ldap user suffix (G)

This parameter specifies where users are added to the tree. If this parameter is not specified, the value from ldap suffix.

缺 省 设 置 : none

level2 oplocks (S)

这 个 参 数 控 制 了 是 否 Samba在 一 个 共 享 上 支 持 第 二 级 (只 读 )oplocks。

2级 ,或 者 只 读 oplocks允 许 Windows NT客 户 在 文 件 中 可 以 保 持 一 个 oplocks,一 旦 第 二 个 用 户 请 求 同 一 文 件 时 可 以 从 读 写 oplocks级 降 为 只 读 oplocks(而 不 是 像 传 统 的 做 法 ， 保 持 唯 一 的 oplocks， 在 第 二 次 打 开 时 释 放 所 有 的 oplocks).这 样 就 可 以 允 许 支 持 2级 oplocks的 文 件 打 开 者 缓 存 用 于 只 读 的 文 件 (也 就 是 说 ,他 们 的 写 和 锁 定 请 求 不 可 能 被 缓 冲 ),并 且 使 只 读 文 件 的 大 量 访 问 提 升 性 能 (例 如 .exe文 件 ).

一 旦 在 拥 有 只 读 oplocks的 客 户 中 有 一 位 对 文 件 进 行 了 写 操 作 ,所 有 的 客 户 都 会 被 通 知 (不 需 要 回 复 及 等 待 ), told to break their oplocks to "none",然 后 删 除 所 有 read-ahead caches.

推 荐 打 开 这 个 选 项 ， 为 共 享 的 可 执 行 程 序 提 高 访 问 速 度 。

更 多 关 于 2级 oplocks的 讨 论 请 查 看 CIFS的 规 约 .

当 前 ,如 果 使 用 了 kernel oplocks的 话 ,就 不 会 认 可 2级 oplocks(即 使 把 那 个 选 项 设 为 yes也 没 用 ).还 要 注 意 ,oplocks 选 项 必 须 在 共 享 上 被 设 成 yes才 有 效 果 .

参 见 oplocks 和 kernel oplocks 选 项 。

缺 省 设 置 : level2 oplocks = yes

lm announce (G)

这 个 选 项 决 定 nmbd(8)是 否 产 生 "Lanman宣 告 广 播 ",OS/2的 客 户 端 需 要 这 个 广 播 用 以 在 它 们 的 浏 览 列 表 里 看 到 Samba服 务 器 .这 个 选 项 有 3个 值 :yes、 no、 auto.缺 省 值 是 auto.如 果 这 值 为 no,Samba将 不 会 产 生 这 种 广 播 .如 果 设 置 为 yes,Samba将 以 lm interval选 项 的 值 为 频 率 产 生 这 种 广 播 .如 果 设 置 为 auto,Samba并 不 发 出 这 类 广 播 ,但 是 侦 听 他 们 .如 果 收 到 这 样 的 广 播 ,它 就 开 始 发 送 这 种 广 播 ,频 率 还 是 以 lm interval选 项 设 定 的 为 准 .

参 见 lm interval.

缺 省 设 置 : lm announce = auto

示 例 : lm announce = yes

lm interval (G)

如 果 Samba设 置 为 产 生 "Lanman宣 告 广 播 （ 给 OS/2客 户 端 使 用 ,参 见 lm announce选 项 ） .那 么 ,这 里 的 选 项 设 定 了 以 秒 为 单 位 的 发 生 频 率 .如 果 这 个 选 项 设 置 为 "0",则 不 管 lm announce选 项 的 值 ,永 远 不 会 发 出 任 何 "Lanman宣 告 广 播 ".

参 见 lm announce.

缺 省 设 置 : lm interval = 60

示 例 : lm interval = 120

load printers (G)

这 个 布 尔 值 控 制 是 否 在 "printcap"文 件 中 的 所 有 打 印 机 将 会 被 缺 省 的 安 装 到 Samba环 境 ,并 且 可 以 被 浏 览 .参 见 "printers"段 获 得 更 多 细 节 .

缺 省 设 置 : load printers = yes

local master (G)

这 个 选 项 允 许 nmbd(8)试 着 去 成 为 本 地 子 网 的 主 控 浏 览 器 .如 果 选 项 值 为 no, nmbd不 会 去 争 取 这 个 权 利 .在 缺 省 情 况 下 ,这 个 值 为 yes.设 置 这 个 值 为 yes,并 不 意 味 着 become 就 一 定 会 成 为 本 地 的 主 浏 览 器 ,只 是 意 味 着 become 会 参 加 成 为 主 浏 览 器 的 选 举 .

设 置 这 个 值 为 no 将 使 nmbd 永 远 不 会 成 为 主 控 浏 览 器 。

缺 省 设 置 : local master = yes

lock dir (G)

与 lock directory 同 义 .

lock directory (G)

这 个 选 项 指 出 "加 锁 文 件 "放 置 的 目 录 .加 锁 文 件 用 以 实 现 最 大 连 接 数 max connections.

缺 省 设 置 : lock directory = ${prefix}/var/locks

示 例 : lock directory = /var/run/samba/locks

locking (S)

这 个 选 项 控 制 当 客 户 端 发 出 锁 定 请 求 时 ,服 务 器 是 否 执 行 "锁 定 ".

如 果 locking = no ,所 有 的 锁 定 请 求 和 解 除 锁 定 请 求 将 表 现 为 成 功 执 行 .对 锁 定 的 查 询 将 会 显 示 没 有 锁 定 .

如 果 locking = yes 服 务 器 将 执 行 真 正 的 锁 定 。

这 个 选 项 可 能 对 只 读 文 件 系 统 有 用 ,因 为 它 可 能 不 需 要 锁 定 （ 例 如 :CDROM） .即 使 在 这 种 情 况 下 ,我 们 也 不 真 正 推 荐 使 用 no.

要 特 别 小 心 ,不 管 是 全 局 的 关 闭 这 个 选 项 或 者 在 某 个 服 务 上 关 闭 这 个 选 项 ,都 有 可 能 由 于 缺 少 锁 定 而 导 致 数 据 损 坏 .其 实 ,你 根 本 就 不 需 要 设 置 这 个 选 项 .

缺 省 设 置 : locking = yes

lock spin count (G)

This parameter controls the number of times that smbd should attempt to gain a byte range lock on the behalf of a client request. Experiments have shown that Windows 2k servers do not reply with a failure if the lock could not be immediately granted, but try a few more times in case the lock could later be aquired. This behavior is used to support PC database formats such as MS Access and FoxPro.

缺 省 设 置 : lock spin count = 3

lock spin time (G)

The time in microseconds that smbd should pause before attempting to gain a failed lock. See lock spin count for more details.

缺 省 设 置 : lock spin time = 10

log file (G)

这 个 选 项 允 许 设 置 其 它 的 文 件 名 字 来 替 代 Samba日 志 文 件 （ 也 就 是 调 试 文 件 ).

这 个 选 项 支 持 标 准 的 文 件 名 代 换 变 量 ,允 许 方 便 的 为 每 个 用 户 或 者 机 器 设 置 专 用 的 日 志 文 件 .

示 例 : log file = /usr/local/samba/var/log.%m

log level (G)

这 个 值 (字 符 串 )允 许 在 smb.conf里 定 义 调 试 水 平 (记 录 水 平 ).This parameter has been extended since the 2.2.x series, now it allow to specify the debug level for multiple debug classes. 这 给 系 统 配 置 带 来 更 大 的 灵 活 性 .

缺 省 的 调 试 水 平 将 在 命 令 行 里 定 义 ,如 果 没 有 定 义 ,调 试 水 平 为 零 .

示 例 : log level = 3 passdb:5 auth:10 winbind:2

logon drive (G)

这 个 选 项 设 置 一 个 本 地 路 径 （ 可 以 理 解 为 网 络 映 射 盘 ） ,当 登 录 时 ,用 户 的 主 目 录 就 连 接 到 这 个 本 地 路 径 (参 见 logon home).

注 意 :这 个 选 项 只 有 在 Samba是 登 录 服 务 器 时 才 有 用 .

缺 省 设 置 : logon drive = z:

示 例 : logon drive = h:

logon home (G)

当 Win95/98或 Win NT工 作 站 登 录 到 Samba PDC时 ,它 们 的 主 目 录 的 位 置 .设 置 了 这 个 选 项 ,就 允 许 在 (DOS)提 示 符 下 使 用 形 如 :

C:\> NET USE H: /HOME

这 样 的 命 令 。

这 个 选 项 支 持 标 准 的 命 令 选 项 替 换 ,方 便 为 每 个 用 户 或 者 机 器 提 供 登 录 脚 本 .

This parameter can be used with Win9X workstations to ensure that roaming profiles are stored in a subdirectory of the user’s home directory. This is done in the following way:

logon home = \%NUrofile

This tells Samba to return the above string, with substitutions made when a client requests the info, generally in a NetUserGetInfo request. Win9X clients truncate the info to \\server\share when a user does net use /home but use the whole string when dealing with profiles.

Note that in prior versions of Samba, the logon path was returned rather than logon home. This broke net use /home but allowed profiles outside the home directory. The current implementation is correct, and can be used for profiles if you use the above trick.

注 意 ,这 个 选 项 只 在 Samba被 设 置 成 为 登 录 服 务 器 logon server时 才 起 作 用 .

缺 省 设 置 : logon home = "\%NU"

示 例 : logon home = "\remote_smb_serverU"

logon path (G)

这 个 选 项 指 定 了 存 放 roaming profile(WindowsNT的 NTuser.dat 等 文 件 )的 用 户 目 录 .Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming profiles. To find out how to handle roaming profiles for Win 9X system, see the logon home parameter.

这 个 选 项 支 持 标 准 替 换 ,允 许 你 为 每 一 个 用 户 或 机 器 设 置 不 同 的 登 录 脚 本 .它 也 可 以 指 定 那 些 显 示 在 Windows NT客 户 端 上 的 "应 用 程 序 数 据 "(桌 面 ,开 始 菜 单 ,网 上 邻 居 和 程 序 等 文 件 夹 和 他 们 的 内 容 ).

指 定 的 共 享 资 源 和 路 径 必 须 是 用 户 可 读 的 ,这 样 ,设 定 的 选 项 和 目 录 才 能 被 Windows NT客 户 端 装 载 使 用 .这 个 共 享 资 源 在 用 户 第 一 次 登 录 时 必 须 是 可 写 的 ,这 样 Windows NT客 户 端 才 能 建 立 NTuser.dat文 件 及 其 他 目 录 .

然 后 ,这 些 目 录 以 及 其 中 的 任 何 内 容 都 可 以 根 据 需 要 设 置 为 只 读 的 .把 NTuser.dat文 件 设 置 成 只 读 是 不 明 智 的 ,你 应 该 把 它 改 名 成 NTuser.man(一 个 强 制 使 用 (MANdatory)的 user.dat)来 达 到 同 样 的 目 的 .

Windows终 端 有 时 候 即 使 没 有 用 户 登 录 也 会 保 持 对 [homes]共 享 资 源 的 连 接 .因 此 ,logon path不 能 包 含 对 homes共 享 资 源 的 任 何 参 照 (也 就 是 说 ,把 这 个 选 项 设 置 成 类 似 \\%N\HOMES\profile_path会 引 起 问 题 ).

这 个 选 项 支 持 标 准 替 换 ,允 许 你 为 不 同 的 机 器 或 用 户 设 置 不 同 的 登 录 脚 本 .

注 意 ,这 个 选 项 只 有 在 Samba被 设 置 成 为 登 录 服 务 器 logon server的 时 候 才 起 作 用 .

缺 省 设 置 : logon path = \\%N\%U\profile

示 例 : logon path = \\PROFILESERVER\PROFILE\%U

logon script (G)

这 个 选 项 指 明 ,当 一 个 用 户 成 功 的 登 录 后 ,将 会 自 动 下 载 到 本 地 执 行 的 脚 本 文 件 ,这 个 脚 本 文 件 可 能 是 一 个 批 处 理 文 件 （ .bat） 或 者 一 个 NT命 令 文 件 （ .cmd） .这 个 脚 本 文 件 必 须 使 用 DOS风 格 的 回 车 /换 行 （ CR/LF） 来 结 束 每 一 行 ,因 此 ,我 们 推 荐 使 用 DOS风 格 的 文 本 编 辑 器 来 建 立 这 个 文 件 .

脚 本 文 件 的 存 放 位 置 必 须 是 相 对 于 [netlogon]服 务 中 指 明 的 目 录 路 径 ,举 例 来 说 ,如 果 [netlogon]服 务 指 定 了 了 一 个 path是 /usr/local/samba/netlogon,而 logon script = STARTUP.BAT, 那 么 将 要 下 载 到 客 户 端 执 行 的 文 件 的 实 际 存 放 位 置 是 :

/usr/local/samba/netlogon/STARTUP.BAT

登 录 脚 本 的 内 容 包 含 什 么 ,完 全 由 你 决 定 .我 们 建 议 包 含 这 个 指 令 :NET TIME \SERVER /SET /YES,它 强 迫 每 一 台 机 器 的 时 间 和 服 务 器 的 时 间 同 步 （ 以 服 务 器 的 时 间 为 准 ） ； 另 一 个 建 议 是 映 射 公 共 工 具 盘 :NET USE U:\\SERVER\"公 共 工 具 目 录 " 例 如 :

NET USE Q:\SERVERISO9001_QA

注 意 :在 一 个 有 安 全 要 求 的 系 统 环 境 中 ,特 别 重 要 的 是 要 记 住 不 要 允 许 客 户 在 [netlogon]上 有 写 的 权 限 ,也 不 要 给 以 客 户 改 写 登 录 脚 本 文 件 的 权 利 .如 果 允 许 客 户 随 意 的 修 改 ,安 全 规 则 就 给 撕 裂 了 一 个 口 子 .

这 个 选 项 支 持 标 准 的 置 换 规 则 ,允 许 你 为 每 个 不 同 的 用 户 或 机 器 定 制 不 同 的 登 录 脚 本 .

注 意 ,这 个 选 项 只 有 在 Samba设 置 为 登 录 服 务 器 时 才 起 作 用 .

缺 省 设 置 : no logon script defined

示 例 : logon script = scriptsU.bat

lppause command (S)

这 个 选 项 指 定 在 服 务 器 上 中 断 指 定 的 打 印 作 业 的 打 印 或 假 脱 机 打 印 操 作 所 使 用 的 指 令 .

这 个 指 令 应 该 是 一 个 可 以 根 据 打 印 机 名 和 作 业 号 中 断 打 印 作 业 的 程 序 或 脚 本 .实 现 这 个 操 作 的 一 个 办 法 是 使 用 作 业 优 先 级 ,优 先 级 别 太 低 的 作 业 不 会 被 发 送 到 打 印 机 上 .

用 %p置 换 可 以 取 得 打 印 机 名 ,而 %j会 被 打 印 作 业 号 (一 个 整 数 )置 换 .在 HPUX系 统 中 (参 见 printing=hpux ),如 果 给 lpq命 令 加 上 -p%p选 项 ,打 印 作 业 会 显 示 其 执 行 状 态 ,具 体 的 说 ,如 果 作 业 的 优 先 级 低 于 阻 塞 级 别 ,它 会 显 示 ’PAUSED’状 态 ,反 之 ,如 果 作 业 的 优 先 级 等 于 或 高 于 阻 塞 级 别 ,它 会 显 示 ’SPOOLED’或 ’PRINTING’状 态 .

注 意 ,在 这 个 设 置 中 使 用 绝 对 路 径 是 一 个 好 习 惯 ,因 为 这 个 路 径 有 可 能 不 在 服 务 器 的 PATH环 境 变 量 中 .

参 见 printing parameter选 项 .

缺 省 设 置 : 目 前 这 个 选 项 没 有 缺 省 设 置 ,除 非 printing选 项 设 置 SYSV,在 这 种 情 况 下 ,缺 省 参 数 是 :

lp -i %p-%j -H hold

或 者 在 printing选 项 设 置 为 softq时 ,缺 省 选 项 是 :

qstat -s -j%j -h

在 HPUX系 统 中 的 例 子 : lppause command = /usr/bin/lpalt %p-%j -p0

lpq cache time (G)

此 选 项 控 制 了 lpq信 息 多 长 时 间 被 缓 冲 一 次 ,以 防 止 频 繁 调 用 lpq命 令 .每 一 次 系 统 使 用 lpq命 令 会 保 留 一 个 单 独 的 缓 冲 ,所 以 如 果 不 同 的 用 户 分 别 使 用 了 不 同 的 lpq命 令 的 话 ,他 们 不 可 能 共 享 缓 冲 信 息 .

缓 冲 文 件 被 存 放 在 /tmp/lpq.xxxx文 件 中 ,其 中 的 xxxx是 正 在 使 用 的 lpq命 令 哈 希 表 .

这 个 选 项 的 缺 省 值 是 10秒 ,这 就 是 说 以 前 相 同 的 lpq命 令 的 缓 冲 内 容 将 在 周 期 为 10秒 内 被 使 用 .如 果 lpq命 令 非 常 慢 的 话 ,可 以 取 稍 大 的 值 .

把 这 个 值 设 为 0就 完 全 禁 止 了 缓 冲 技 术 的 使 用 .

参 见 printing 选 项 .

缺 省 设 置 : lpq cache time = 10

示 例 : lpq cache time = 30

lpq command (S)

这 个 选 项 指 定 为 了 获 得 lpq风 格 的 打 印 机 状 态 信 息 而 要 在 服 务 器 上 要 执 行 的 命 令 .

这 个 命 令 应 该 是 一 个 只 以 打 印 机 名 作 为 选 项 并 可 以 输 出 打 印 机 状 态 信 息 的 程 序 或 脚 本 .

通 常 支 持 九 种 打 印 机 状 态 信 息 :CUPS, BSD,AIX,LPRNG,PLP,SYSV,HPUX,QNX和 SOFTQ.而 这 些 正 好 覆 盖 了 大 多 数 的 UNIX系 统 .你 可 以 用 printing =选 项 来 控 制 到 底 要 用 哪 种 类 型 .

有 些 客 户 端 (特 别 是 Windows for Workgroups)可 能 不 能 正 确 地 向 打 印 机 发 送 联 接 号 以 获 得 状 态 信 息 .对 此 ,服 务 器 会 向 客 户 报 告 它 所 联 接 的 首 个 打 印 服 务 .这 样 的 情 况 只 当 联 接 号 发 送 非 法 时 才 会 发 生 .

如 果 使 用 %p变 量 的 话 ,系 统 会 在 此 处 放 置 打 印 机 名 .否 则 在 命 令 后 放 置 打 印 机 名 .

注 意 ,当 服 务 器 不 能 获 得 PATH变 量 的 话 ,以 绝 对 路 径 来 描 述 lpq command是 个 好 习 惯 . 当 与 CUPS库 编 译 连 接 时 ， 不 需 要 lpq command， 因 为 smbd将 使 用 库 调 用 来 获 得 打 印 队 列 列 表 。

参 见 printing 选 项 .

缺 省 设 置 : 依 赖 于 printing 的 设 置 情 况

示 例 : lpq command = /usr/bin/lpq -P%p

lpresume command (S)

此 选 项 指 定 为 了 继 续 连 续 打 印 或 假 脱 机 一 个 指 定 的 打 印 任 务 时 要 在 服 务 器 上 执 行 的 命 令 .

此 命 令 应 该 是 一 个 以 打 印 机 名 和 要 恢 复 的 打 印 任 务 号 作 为 选 项 的 程 序 或 脚 本 .参 见 lppause command 参 数 。

如 果 使 用 %p变 量 的 话 ,系 统 会 在 此 处 放 置 打 印 机 名 .用 %j来 代 替 打 印 任 务 号 ,当 然 是 用 整 数 形 式 罗 .

注 意 ,当 服 务 器 不 能 获 得 PATH变 量 的 话 ,以 绝 对 路 径 来 描 述 lpresume command是 个 好 习 惯

参 见 printing 选 项 .

缺 省 设 置 : 当 前 没 有 缺 省 设 置 ， 除 非 printing 选 项 是 SYSV, 此 时 默 认 是

lp -i %p-%j -H resume

或 者 如 果 printing 选 项 是 SOFTQ, 那 么 默 认 是 :

qstat -s -j%j -r

HPUX的 示 例 : lpresume command = /usr/bin/lpalt %p-%j -p2

lprm command (S)

此 选 项 指 定 为 了 要 删 除 一 个 打 印 任 务 而 需 要 在 服 务 器 上 执 行 的 命 令 .

此 命 令 应 该 是 一 个 使 用 打 印 机 名 和 打 印 任 务 号 的 程 序 或 脚 本 ,并 且 执 行 它 们 可 以 删 掉 打 印 任 务 .

如 果 使 用 %p变 量 的 话 ,系 统 会 在 此 处 放 置 打 印 机 名 .用 %j来 代 替 打 印 任 务 号 ,当 然 是 也 用 整 数 形 式 罗 .

注 意 ,当 不 能 从 服 务 器 获 得 PATH变 量 的 话 ,以 绝 对 路 径 来 描 述 lprm command是 个 好 习 惯 .

参 见 printing 选 项 .

缺 省 设 置 : 依 赖 于 printing 选 项 设 置

示 例 1: lprm command = /usr/bin/lprm -P%p %j

示 例 2: lprm command = /usr/bin/cancel %p-%j

machine password timeout (G)

如 果 samba服 务 器 是 Windows NT域 成 员 的 话 (参 见 security=domain选 项 ),那 么 运 行 中 的 smbd进 程 会 周 期 性 地 试 着 改 变 储 存 在 叫 做 private/secrets.tdb的 TDB中 的 MACHINE ACCOUNT PASSWORD.这 个 参 数 指 定 了 密 码 将 多 久 更 换 一 次 ， 以 秒 为 单 位 。 缺 省 值 是 一 个 星 期 (当 然 要 以 秒 来 表 示 ),这 与 NT域 成 员 服 务 器 是 一 样 的 .

参 见 smbpasswd(8), 和 security = domain 选 项 .

缺 省 设 置 : machine password timeout = 604800

magic output (S)

此 选 项 指 定 了 一 个 用 magic脚 本 输 出 内 容 而 建 立 的 文 件 的 名 称 ,参 见 下 面 对 magic script选 项 的 描 述 .

警 告 :如 果 两 个 客 户 在 同 样 的 目 录 下 用 相 同 的 magic script,输 出 文 件 内 容 是 无 法 确 定 的 .

缺 省 设 置 : magic output = <magic script name>.out

示 例 : magic output = myfile.txt

magic script (S)

这 个 选 项 用 来 指 定 将 被 服 务 器 执 行 的 文 件 的 名 字 ,这 个 文 件 如 果 已 经 打 开 ,那 么 ,当 这 个 文 件 关 闭 后 服 务 器 同 样 也 可 以 运 行 .这 样 就 允 许 了 一 个 UNIX脚 本 可 以 传 送 到 samba主 机 ,并 为 所 连 接 的 用 户 运 行 .

以 这 种 方 式 运 行 的 脚 本 将 会 在 完 成 以 后 被 删 除 ,只 要 权 限 允 许 的 话 .

如 果 脚 本 产 生 了 输 出 的 话 ,这 些 信 息 就 被 送 到 magic output选 项 指 定 的 文 件 中 (见 以 上 描 述 ).

注 意 ,一 些 命 令 解 释 器 不 能 解 释 包 含 CR/LF而 不 是 CR回 车 换 行 符 的 脚 本 .magic脚 本 必 须 是 可 以 被 运 行 的 （ 就 象 在 本 地 主 机 运 行 一 样 ） ,而 有 些 脚 本 在 某 些 主 机 上 或 某 些 shell下 可 能 会 在 dos客 户 端 进 行 过 滤 处 理 .

magic脚 本 仍 处 于 实 验 阶 段 ,所 以 不 能 对 此 完 全 依 赖 .

缺 省 设 置 : 无 。 禁 止 使 用 magic script.

示 例 : magic script = user.csh

mangle case (S)

参 见 NAME MANGLING部 分 .

缺 省 设 置 : mangle case = no

mangled map (S)

这 个 选 项 是 用 来 直 接 映 射 那 些 不 能 在 Windows/DOS上 描 述 的 unix文 件 名 .不 过 并 不 经 常 出 现 这 样 的 情 况 ,只 有 一 些 特 殊 的 扩 展 名 在 DOS和 UNIX之 间 才 会 不 同 ,例 如 ,HTML文 件 在 UNIX下 通 常 都 是 .html,而 在 Windows/DOS下 通 常 却 是 .htm.

所 以 如 果 要 将 html 映 射 为 htm 你 应 当 这 样 :

mangled map = (*.html *.htm)

有 一 个 非 常 有 用 的 经 验 是 删 掉 在 CDROM光 盘 上 一 些 文 件 名 后 面 讨 人 厌 的 ;1(只 有 在 一 些 UNIX可 以 看 到 它 们 ).为 此 可 以 这 样 映 射 ： (*;1 *;).

缺 省 设 置 : 没 有 mangled map

示 例 : mangled map = (*;1 *;)

mangled names (S)

这 个 选 项 控 制 是 否 要 把 UNIX下 的 非 DOS文 件 名 映 射 为 DOS兼 容 的 形 式 ("mangled")并 使 得 它 们 可 以 查 阅 ,或 者 简 单 地 忽 略 掉 这 些 非 DOS文 件 名 .

NAME MANGLING部 分 有 更 多 关 于 如 何 控 制 这 类 处 理 的 详 细 信 息 .

如 果 使 用 了 这 种 映 射 ,那 么 其 算 法 就 象 下 面 这 样 ：

把 文 件 名 最 后 一 个 点 符 号 前 面 首 五 个 字 母 数 字 字 符 强 制 转 换 成 大 写 ,作 为 要 映 射 名 字 的 首 五 个 字 符 .

在 要 映 射 名 字 的 起 始 部 分 加 上 "~"符 号 ,后 面 跟 两 个 字 符 的 特 殊 序 列 字 串 ,而 这 个 序 列 字 串 是 由 原 始 的 文 件 名 而 来 （ 也 就 是 ： 原 文 件 名 去 掉 最 后 的 文 件 扩 展 名 ） .只 有 当 文 件 的 扩 展 名 含 有 大 写 字 母 或 长 于 三 个 字 符 时 ,文 件 的 最 后 扩 展 名 才 被 包 含 在 散 列 计 算 中 .

注 意 ,如 果 你 不 喜 欢 ’~’的 话 ,可 以 用 mangling char选 项 来 指 定 你 想 要 的 字 符 .

最 后 ,扩 展 名 部 分 的 前 三 个 字 符 会 被 保 留 ,强 制 转 换 到 大 写 并 作 为 映 射 后 名 字 的 扩 展 名 .最 后 的 扩 展 名 就 是 原 始 文 件 名 中 最 后 一 个 ’.’右 面 的 那 部 分 .如 果 文 件 名 中 没 有 ’.’,那 么 映 射 后 的 文 件 名 也 没 有 扩 展 名 部 分 (除 非 用 了 "hidden files" - 参 见 后 面 的 介 绍 ).

unix的 文 件 名 如 果 以 点 开 始 ,那 么 好 比 DOS中 的 隐 藏 文 件 .这 些 文 件 映 射 后 的 文 件 名 就 会 拿 掉 点 符 号 并 用 "___"来 作 为 它 的 扩 展 名 ,而 不 管 原 来 的 扩 展 名 是 什 么 ("___"是 三 个 下 划 线 ).

大 写 字 母 数 字 字 符 组 成 了 两 位 散 列 值 .

如 果 目 录 中 的 文 件 与 要 映 射 的 文 件 名 使 用 了 相 同 的 前 五 位 字 符 ,这 样 的 算 法 会 导 致 名 称 冲 突 ,不 过 发 生 冲 突 的 可 能 性 是 1/1300.

名 称 映 射 允 许 当 需 要 保 留 unix长 文 件 名 时 在 unix目 录 与 Windows/DOS之 间 拷 贝 文 件 .从 Windows/DOS中 拷 过 来 的 unix文 件 可 以 更 换 新 的 扩 展 名 并 保 留 同 样 的 主 文 件 名 .名 称 映 射 并 不 会 在 转 换 时 更 改 什 么 东 西 .

缺 省 设 置 : mangled names = yes

mangled stack (G)

这 个 选 项 控 制 了 映 射 文 件 名 的 数 量 ,以 便 让 Samba服 务 器 smbd(8)对 其 进 行 缓 存 .

栈 里 保 存 了 最 近 映 射 的 基 本 文 件 名 (扩 展 名 只 有 在 超 过 3个 字 符 或 者 包 含 大 写 字 符 时 才 会 保 留 ).

栈 值 设 得 稍 大 一 些 ,对 于 映 射 unix的 长 文 件 名 操 作 会 更 顺 利 一 些 .但 是 ,它 会 使 目 录 访 问 变 得 更 慢 ； 小 一 些 的 栈 可 以 保 存 在 服 务 器 的 内 存 中 (每 个 栈 元 素 占 256个 字 节 ).

并 不 保 证 在 转 换 长 文 件 名 时 绝 对 正 确 无 误 ,准 备 好 面 对 可 能 出 现 的 惊 奇 .

缺 省 设 置 : mangled stack = 50

示 例 : mangled stack = 100

mangle prefix (G)

controls the number of prefix characters from the original name used when generating the mangled names. A larger value will give a weaker hash and therefore more name collisions. The minimum value is 1 and the maximum value is 6.

mangle prefix is effective only when mangling method is hash2.

缺 省 设 置 : mangle prefix = 1

示 例 : mangle prefix = 4

mangling char (S)

这 个 选 项 指 定 在 name mangling操 作 中 使 用 什 么 样 的 字 符 作 为 magic字 符 .缺 省 是 用 了 ’~’,不 过 有 些 软 件 可 能 会 在 使 用 上 受 到 某 些 妨 碍 .可 以 设 定 为 你 想 要 的 字 符 .

缺 省 设 置 : mangling char = ~

示 例 : mangling char = ^

mangling method (G)

controls the algorithm used for the generating the mangled names. Can take two different values, "hash" and "hash2". "hash" is the default and is the algorithm that has been used in Samba for many years. "hash2" is a newer and considered a better algorithm (generates less collisions) in the names. However, many Win32 applications store the mangled names and so changing to the new algorithm must not be done lightly as these applications may break unless reinstalled.

缺 省 设 置 : mangling method = hash2

示 例 : mangling method = hash

map acl inherit (S)

This boolean parameter controls whether smbd(8) will attempt to map the ’inherit’ and ’protected’ access control entry flags stored in Windows ACLs into an extended attribute called user.SAMBA_PAI. This parameter only takes effect if Samba is being run on a platform that supports extended attributes (Linux and IRIX so far) and allows the Windows 2000 ACL editor to correctly use inheritance with the Samba POSIX ACL mapping code.

缺 省 设 置 : map acl inherit = no

map archive (S)

这 个 选 项 决 定 了 是 否 把 DOS的 归 档 属 性 映 射 为 UNIX可 执 行 位 .在 文 件 修 改 后 DOS的 归 档 位 会 被 设 定 到 文 件 上 .保 持 归 档 位 的 一 个 理 由 是 使 得 Samba或 者 你 的 PC在 新 建 任 何 文 件 的 时 候 ， 不 会 为 它 们 设 置 UNIX可 执 行 属 性 。 那 样 对 于 共 享 源 代 码 、 文 档 等 等 非 常 让 人 厌 烦 。

注 意 这 个 选 项 需 要 在 create mask[u4E2D]没 有 排 除 文 件 属 主 的 执 行 权 限 位 (也 就 是 说 它 必 须 包 含 100).参 见 create mask选 项 中 的 描 述 .

缺 省 设 置 : map archive = yes

map hidden (S)

这 个 选 项 决 定 DOS下 的 隐 藏 文 件 是 否 要 映 射 为 UNIX全 局 可 执 行 位 .

注 意 这 个 选 项 需 要 在 create mask中 没 有 排 除 所 有 用 户 的 执 行 权 限 位 (也 就 是 说 它 必 须 包 含 001).参 见 create mask选 项 中 的 描 述 .

缺 省 设 置 : map hidden = no

map system (S)

这 个 选 项 决 定 DOS下 的 系 统 文 件 是 否 要 映 射 为 UNIX组 可 执 行 位 .

注 意 这 个 选 项 需 要 在 create mask中 没 有 排 除 组 用 户 的 执 行 权 限 位 (也 就 是 说 它 必 须 包 含 010).参 见 create mask选 项 中 的 描 述 .

缺 省 设 置 : map system = no

map to guest (G)

这 个 选 项 只 在 安 全 模 式 不 是 共 享 级 (security=share)时 才 有 用 ,也 就 是 选 用 了 用 户 安 全 级 ,服 务 器 安 全 级 或 者 域 安 全 级 (user, server, 和 domain).

这 时 ,选 项 会 有 三 种 不 同 的 值 ,分 别 通 知 smbd(8)在 用 户 以 非 法 身 份 登 录 时 作 何 相 应 处 理 .

这 三 种 设 定 是 :

Never - 意 思 是 用 户 登 录 时 用 了 个 非 法 口 令 并 且 被 服 务 器 所 拒 .这 是 个 缺 省 值 .

Bad User - 意 思 是 用 户 登 录 时 用 了 非 法 口 令 并 且 被 服 务 器 所 拒 ,除 非 用 户 名 不 存 在 ,否 则 也 可 以 以 来 宾 身 份 登 录 并 映 射 到 对 应 的 guest account账 号 .

Bad Password - 意 思 是 用 户 登 录 时 即 使 用 了 非 法 口 令 ,但 是 还 会 以 来 宾 身 份 登 录 并 映 射 到 对 应 的 guest账 号 .可 能 出 现 这 样 的 问 题 ,就 是 用 户 虽 然 输 错 了 口 令 ,却 非 常 平 静 地 以 “来 宾 ”身 份 登 录 到 系 统 上 。 他 们 不 明 白 为 什 么 他 们 不 能 访 问 那 些 他 们 认 为 可 以 访 问 的 资 源 ,因 为 在 登 录 时 没 有 任 何 信 息 提 示 他 们 输 错 了 口 令 。 所 以 应 该 小 心 使 用 它 ,以 避 免 不 必 要 的 麻 烦 . Helpdesk services will hate you if you set the map to guest parameter this way :-).

注 意 当 使 用 共 享 级 以 外 的 其 它 安 全 模 式 时 ,要 设 定 这 个 选 项 ， 以 使 "Guest"共 享 资 源 服 务 发 挥 作 用 .因 为 在 这 些 安 全 级 模 式 中 ,用 户 请 求 的 共 享 资 源 名 在 服 务 器 成 功 验 证 用 户 登 录 前 不 会 发 送 到 服 务 器 作 处 理 ,所 以 服 务 器 就 在 不 能 处 理 联 接 验 证 结 果 时 为 联 接 提 供 "Guest"共 享 .

对 于 那 些 以 前 的 版 本 ,这 个 选 项 会 映 射 到 编 译 时 所 用 的 local.h文 件 里 定 义 的 GUEST_SESSSETUP变 量 的 值 .

缺 省 设 置 : map to guest = Never

示 例 : map to guest = Bad User

max connections (S)

最 大 联 接 数 就 是 允 许 同 时 联 接 到 一 个 资 源 服 务 的 最 大 数 量 限 制 .在 max connections大 于 0的 情 况 下 ,如 果 联 接 数 超 过 了 最 大 联 接 数 设 定 时 ,超 出 的 联 接 将 被 拒 绝 .如 果 设 为 0的 话 就 没 有 这 样 的 联 接 限 制 了 .

为 了 实 现 这 样 的 功 能 ,系 统 会 使 用 记 录 锁 定 文 件 .锁 定 文 件 存 放 在 lock directory选 项 指 定 的 目 录 中 .

缺 省 设 置 : max connections = 0

示 例 : max connections = 10

max disk size (G)

控 制 磁 盘 使 用 的 上 限 .如 果 把 它 设 为 100的 话 ,所 有 的 共 享 资 源 容 量 都 不 会 超 过 100M.

注 意 这 个 选 项 并 不 是 限 制 管 理 员 往 磁 盘 上 存 放 数 据 的 容 量 .在 上 面 所 说 的 情 况 中 ,管 理 员 仍 然 可 以 存 放 超 过 100M的 数 据 到 磁 盘 上 ,但 如 果 客 户 查 询 剩 余 磁 盘 空 间 或 磁 盘 总 空 间 的 话 ,所 得 到 的 结 果 就 只 在 这 个 max disk size指 定 的 容 量 范 围 之 内 .

使 用 这 个 选 项 主 要 是 为 了 对 一 些 疯 狂 使 用 磁 盘 空 间 的 软 件 进 行 一 定 的 限 制 ,特 别 是 它 们 可 能 会 使 用 超 过 1G上 以 的 磁 盘 空 间 .

把 这 个 选 项 设 为 0说 明 没 有 限 制 .

缺 省 设 置 : max disk size = 0

示 例 : max disk size = 1000

max log size (G)

这 个 选 项 (一 个 kB为 单 位 的 整 数 )用 来 指 定 使 用 的 记 录 文 件 最 大 到 多 少 容 量 .samba会 周 期 性 地 检 查 这 个 容 量 ,如 果 超 过 这 个 选 项 值 就 把 老 的 文 件 换 名 成 扩 展 名 为 .old的 文 件 .

把 这 个 选 项 设 为 0说 明 没 有 限 制 .

缺 省 设 置 : max log size = 5000

示 例 : max log size = 1000

max mux (G)

这 个 选 项 控 制 了 对 用 户 允 许 的 最 大 SMB并 发 操 作 数 .你 应 该 不 需 要 设 定 这 个 选 项 的 .

缺 省 设 置 : max mux = 50

max open files (G)

这 个 选 项 限 定 了 在 任 意 时 间 客 户 端 用 一 个 smbd(8)文 件 服 务 进 程 可 以 打 开 的 最 大 文 件 数 .缺 省 的 值 非 常 高 (10,000),因 为 对 于 每 个 未 打 开 的 文 件 只 使 用 其 中 的 一 位 .

打 开 文 件 极 限 通 常 用 UNIX每 进 程 最 大 文 件 描 述 符 数 来 限 制 更 好 ,所 以 你 不 需 要 去 碰 这 个 选 项 的 .

缺 省 设 置 : max open files = 10000

max print jobs (S)

This parameter limits the maximum number of jobs allowable in a Samba printer queue at any given moment. If this number is exceeded, smbd(8) will remote "Out of Space" to the client. See all total print jobs.

缺 省 设 置 : max print jobs = 1000

示 例 : max print jobs = 5000

max protocol (G)

此 项 的 值 是 一 个 字 符 串 ,定 义 了 服 务 器 支 持 的 最 高 协 议 等 级 .

可 能 的 值 是 :

CORE: 早 期 版 本 ,不 接 受 用 户 名 .

COREPLUS: 在 CORE的 基 础 上 改 进 了 一 些 性 能 .

LANMAN1: 第 一 个 比 较 流 行 的 协 议 ,支 持 长 文 件 名 .

LANMAN2: 对 LANMAN1进 行 了 更 新 .

NT1: 目 前 用 于 Windows NT,一 般 称 为 CIFS.

通 常 ,此 选 项 不 必 设 定 ,因 为 在 SMB协 议 中 会 自 动 协 商 并 选 择 合 适 的 协 议 .

参 见 min protocol

缺 省 设 置 : max protocol = NT1

示 例 : max protocol = LANMAN1

max reported print jobs (S)

This parameter limits the maximum number of jobs displayed in a port monitor for Samba printer queue at any given moment. If this number is exceeded, the excess jobs will not be shown. A value of zero means there is no limit on the number of print jobs reported. See all total print jobs and max print jobs parameters.

缺 省 设 置 : max reported print jobs = 0

示 例 : max reported print jobs = 1000

max smbd processes (G)

This parameter limits the maximum number of smbd(8) processes concurrently running on a system and is intended as a stopgap to prevent degrading service to clients in the event that the server has insufficient resources to handle more than this number of connections. Remember that under normal operating conditions, each user will have an smbd(8) associated with him or her to handle connections to all shares from a given host.

缺 省 设 置 : max smbd processes = 0 ## no limit

示 例 : max smbd processes = 1000

max ttl (G)

这 个 选 项 通 知 nmbd(8) 当 它 用 广 播 或 从 WINS服 务 器 请 求 一 个 名 字 时 ,这 个 NetBIOS名 字 的 有 效 时 间 (’time to live’, 以 秒 计 )是 多 长 .你 不 需 要 去 碰 这 个 选 项 ,缺 省 值 是 3天 .

缺 省 设 置 : max ttl = 259200

max wins ttl (G)

这 个 选 项 通 知 smbd(8)程 序 当 它 作 为 一 个 WINS服 务 器 时 (wins support =true),nmbd承 认 的 最 长 NetBIOS名 字 生 存 时 间 (’time to live’,以 秒 计 ).你 不 需 要 去 改 变 这 个 选 项 的 ,缺 省 值 是 6天 (518400秒 ).

参 见 min wins ttl 选 项 .

缺 省 设 置 : max wins ttl = 518400

max xmit (G)

这 个 选 项 控 制 通 过 samba的 最 大 包 容 量 .缺 省 值 是 65535,同 时 这 也 是 最 大 值 .有 时 你 可 能 用 一 个 较 小 的 值 可 以 得 到 更 好 的 性 能 .不 过 低 于 2048通 常 会 有 一 些 问 题 .

缺 省 设 置 : max xmit = 65535

示 例 : max xmit = 8192

message command (G)

当 服 务 器 接 收 到 一 个 WinPopup类 似 的 信 息 时 运 行 一 个 指 定 的 命 令 .

通 常 这 个 命 令 所 做 之 事 都 取 决 于 你 的 想 象 .

例 如 :

message command = csh -c ’xedit %s;rm %s’ &

这 个 命 令 用 xedit发 出 一 条 信 息 ,然 后 再 删 除 它 .注 意 很 重 要 的 一 点 是 这 个 命 令 应 该 立 即 返 回 .这 就 是 为 什 么 在 行 末 用 ’&’的 原 因 .如 果 它 没 有 立 即 返 回 的 话 ,计 算 机 可 能 会 在 发 送 信 息 时 当 掉 的 (不 过 一 般 都 会 在 30秒 后 恢 复 ).

所 有 信 息 都 被 以 全 局 访 客 用 户 身 份 发 送 .命 令 可 以 使 用 标 准 的 替 换 符 ,不 过 %u将 不 会 有 效 (在 这 里 用 %U可 能 更 好 ).

除 了 标 准 替 换 的 部 分 ,还 可 以 应 用 一 些 附 加 的 替 换 ,比 如 :

%s =包 含 消 息 的 文 件 名

%t = 发 送 信 息 的 目 标 (很 可 能 是 服 务 器 名 ).

%f = 信 息 的 来 源 .

你 可 以 用 这 个 命 令 来 发 送 邮 件 或 者 你 想 要 的 内 容 .如 果 你 有 关 于 发 送 内 容 的 好 主 意 请 通 知 开 发 人 员 .

有 个 例 子 可 以 以 邮 件 形 式 发 送 信 息 给 root：

message command = /bin/mail -s ’message from %f on %m’ root < %s; rm %s

如 果 没 有 指 定 发 送 信 息 所 用 的 命 令 ,那 么 这 个 信 息 并 不 会 被 发 出 ,同 时 Samba向 发 送 者 报 告 出 错 .不 幸 的 是 WfWg(Windows for Workgrups)完 全 忽 略 出 错 代 码 ,提 示 信 息 已 被 发 出 .

如 果 你 想 要 悄 悄 地 删 掉 它 的 话 请 用 ：

message command = rm %s

缺 省 设 置 : 没 有 message command

示 例 : message command = csh -c ’xedit %s; rm %s’ &

min passwd length (G)

与 min password length 同 义 .

min password length (G)

此 项 设 定 当 执 行 变 更 UNIX口 令 时 smbd接 受 的 明 文 口 令 的 最 小 字 符 长 度 .

参 见 unix password sync, passwd program和 passwd chat debug 选 项 .

缺 省 设 置 : min password length = 5

min print space (S)

此 项 设 定 一 个 用 户 假 脱 机 打 印 作 业 必 须 的 最 小 剩 余 磁 盘 空 间 .当 然 是 用 kB 为 单 位 .缺 省 设 为 0,就 是 说 用 户 总 是 可 以 假 脱 机 打 印 作 业 .

参 见 printing 选 项 。

缺 省 设 置 : min print space = 0

示 例 : min print space = 2000

min protocol (G)

The value of the parameter (a string) is the lowest SMB protocol dialect than Samba will support. Please refer to the max protocol parameter for a list of valid protocol names and a brief description of each. You may also wish to refer to the C source code in source/smbd/negprot.c for a listing of known protocol dialects supported by clients.

If you are viewing this parameter as a security measure, you should also refer to the lanman auth 选 项 。 Otherwise, you should never need to change this 选 项 。

Default : min protocol = CORE

Example : min protocol = NT1 # disable DOS clients

min wins ttl (G)

此 项 通 知 nmbd(8)当 以 WINS服 务 器 的 形 式 (wins support = yes)执 行 时 ,它 所 承 认 的 NetBIOS名 字 的 最 小 有 效 时 间 (以 秒 为 单 位 ).这 个 选 项 无 需 更 改 ,缺 省 是 6小 时 (21600秒 )

缺 省 设 置 : min wins ttl = 21600

msdfs proxy (S)

This parameter indicates that the share is a stand-in for another CIFS share whose location is specified by the value of the 选 项 。 When clients attempt to connect to this share, they are redirected to the proxied share using the SMB-Dfs protocol.

Only Dfs roots can act as proxy shares. Take a look at the msdfs root and host msdfs options to find out how to set up a Dfs root share.

示 例 : msdfs proxy = \\otherserver\someshare

msdfs root (S)

If set to yes, Samba treats the share as a Dfs root and allows clients to browse the distributed file system tree rooted at the share directory. Dfs links are specified in the share directory by symbolic links of the form msdfs:serverA\\shareA,serverB\\shareB and so on. For more information on setting up a Dfs tree on Samba, refer to ???.

参 见 host msdfs

缺 省 设 置 : msdfs root = no

name cache timeout (G)

Specifies the number of seconds it takes before entries in samba’s hostname resolve cache time out. If the timeout is set to 0. the caching is disabled.

缺 省 设 置 : name cache timeout = 660

示 例 : name cache timeout = 0

name resolve order (G)

samba套 件 中 的 一 些 程 序 使 用 此 项 来 决 定 使 用 的 名 字 服 务 以 及 解 析 主 机 名 到 IP地 址 的 次 序 .主 要 目 的 是 控 制 netbios名 称 怎 样 解 析 。 此 选 项 列 出 不 同 的 名 字 解 析 选 项 ， 以 空 格 为 分 隔 符 .

这 些 名 字 解 析 选 项 是 ： "lmhosts","host","wins"和 "bcast".它 们 决 定 了 名 字 解 析 是 以 如 下 方 式 的 ：

lmhosts : 在 samba的 lmhosts文 件 中 查 找 IP地 址 .如 果 lmhosts文 件 的 内 容 行 中 没 有 名 字 类 型 附 加 在 NetBIOS名 上 时 (参 见 lmhosts (5)中 的 详 细 描 述 ),任 何 类 型 的 名 字 都 可 以 匹 配 这 个 查 询 .

host : 执 行 标 准 的 主 机 名 到 IP地 址 的 解 析 操 作 ,此 操 作 会 使 用 系 统 的 /etc/hosts,NIS或 者 是 DNS来 查 询 .具 体 方 法 取 决 于 操 作 系 统 ,在 IRIX和 Solaris中 解 析 名 字 的 方 法 可 能 是 由 /etc/nsswitch.conf文 件 来 控 制 的 .注 意 此 方 法 只 适 用 于 对 被 查 询 的 NetBIOS名 字 类 型 为 0x20(服 务 器 )或 者 是 0x1c(域 控 制 器 )时 才 有 用 ,其 它 类 型 都 会 被 忽 略 .后 一 种 情 况 只 在 活 动 目 录 域 中 有 用 ， 返 回 一 个 匹 配 _ldap._tcp.domain 的 SRV RR条 目 的 DNS 查 询 。

wins : 向 列 在 wins server选 项 中 的 服 务 器 查 询 一 个 名 字 对 应 的 IP地 址 .如 果 没 有 指 定 WINS服 务 器 ,那 么 此 方 法 就 被 略 过 了 .

bcast : 向 在 interfaces选 项 中 列 出 的 每 一 个 已 知 本 地 网 络 接 口 进 行 广 播 来 作 查 询 .这 是 最 不 可 信 的 名 字 解 析 方 法 ,除 非 目 标 主 机 就 在 本 地 子 网 中 .

缺 省 设 置 : name resolve order = lmhosts host wins bcast

示 例 : name resolve order = lmhosts bcast host

在 上 例 中 首 先 检 查 本 地 lmhosts文 件 ,然 后 尝 试 广 播 ,接 下 来 就 是 用 通 常 的 系 统 主 机 名 查 询 方 式 了 .

When Samba is functioning in ADS security mode (security = ads) it is advised to use following settings for name resolve order:

name resolve order = wins bcast

DC lookups will still be done via DNS, but fallbacks to netbios names will not inundate your DNS servers with needless querys for DOMAIN<0x1c> lookups.

netbios aliases (G)

此 项 指 定 一 串 NetBIOS名 字 让 nmbd作 为 附 加 的 名 字 进 行 宣 布 .这 样 就 使 一 个 机 器 在 可 浏 览 列 表 中 可 以 出 现 多 个 名 字 形 式 .如 果 主 机 是 浏 览 服 务 器 或 登 录 服 务 器 , 就 不 会 出 现 这 些 附 加 的 别 名 ,而 只 会 使 用 它 的 初 始 名 字 .

参 见 netbios name 选 项 。

缺 省 设 置 : 空 字 符 串 (没 有 附 加 的 名 字 )

示 例 : netbios aliases = TEST TEST1 TEST2

netbios name (G)

此 项 对 一 已 知 的 samba服 务 器 设 置 它 的 NetBIOS名 .缺 省 情 况 下 会 使 用 此 主 机 DNS名 字 的 主 机 名 部 分 .如 果 这 个 服 务 器 是 作 浏 览 服 务 器 或 登 录 服 务 器 时 (或 是 主 机 DNS名 的 第 一 个 成 分 时 ),这 个 服 务 器 名 将 成 为 这 些 服 务 对 外 宣 布 时 所 用 的 名 字 .

参 见 netbios aliases 选 项

缺 省 设 置 : machine DNS name

示 例 : netbios name = MYNAME

netbios scope (G)

This sets the NetBIOS scope that Samba will operate under. This should not be set unless every machine on your LAN also sets this value.

nis homedir (G)

此 项 从 NIS映 射 表 中 取 得 有 效 共 享 服 务 器 .对 于 用 自 动 装 载 程 序 的 UNIX系 统 来 说 ,用 户 的 主 目 录 经 常 根 据 需 要 从 远 程 服 务 器 装 载 到 一 个 需 要 的 工 作 站 上 .

如 果 samba登 录 服 务 器 不 是 作 为 真 正 主 目 录 服 务 器 而 是 通 过 NFS来 实 现 ,却 通 知 用 户 以 SMB服 务 器 来 使 用 主 目 录 时 ,用 户 装 载 主 目 录 来 进 行 访 问 需 要 两 个 网 络 跳 步 (一 个 以 SMB方 式 ,另 一 个 以 NFS方 式 装 载 ).这 样 的 使 用 方 式 是 非 常 慢 的 .

此 选 项 允 许 当 Samba在 主 目 录 服 务 器 方 式 运 行 时 让 samba反 馈 目 录 服 务 器 而 非 登 录 服 务 器 上 的 主 共 享 资 源 ,这 样 samba用 户 可 以 直 接 从 目 录 服 务 器 上 装 载 目 录 .当 samba把 目 录 共 享 资 源 反 馈 给 用 户 ,这 时 它 会 参 考 homedir map选 项 指 定 的 NIS映 射 表 然 后 再 反 馈 表 中 列 出 的 服 务 .

注 意 要 使 此 项 起 作 用 必 须 有 一 个 运 作 中 的 NIS系 统 ,并 且 samba服 务 器 必 须 是 一 个 登 录 服 务 器 。

缺 省 设 置 : nis homedir = no

nt acl support (S)

此 布 尔 量 选 项 控 制 是 否 让 smbd(8)尝 试 把 UNIX权 限 映 射 到 NT的 访 问 控 制 列 表 .这 个 参 数 在 2.2.2之 前 是 一 个 全 局 选 项 。

缺 省 设 置 : nt acl support = yes

ntlm auth (G)

This parameter determines whether or not smbd(8) will attempt to authenticate users using the NTLM encrypted password response. If disabled, either the lanman password hash or an NTLMv2 response will need to be sent by the client.

If this option, and lanman auth are both disabled, then only NTLMv2 logins will be permited. Not all clients support NTLMv2, and most will require special configuration to us it.

Default : ntlm auth = yes

nt pipe support (G)

此 布 尔 量 选 项 控 制 是 否 让 smbd(8)允 许 Windows NT用 户 联 接 到 NT的 特 殊 SMB管 道 IPC$.这 通 常 是 开 发 者 所 用 的 调 试 项 ,其 它 用 户 可 以 不 管 .

缺 省 设 置 : nt pipe support = yes

nt status support (G)

This boolean parameter controls whether smbd(8) will negotiate NT specific status support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone. If this option is set to no then Samba offers exactly the same DOS error codes that versions prior to Samba 2.2.3 reported.

You should not need to ever disable this 选 项 。

缺 省 设 置 : nt status support = yes

null passwords (G)

Allow or disallow client access to accounts that have null passwords. 允 许 或 禁 止 用 户 以 空 口 令 使 用 账 号 .

参 见 smbpasswd(5).

缺 省 设 置 : null passwords = no

obey pam restrictions (G)

When Samba 3.0 is configured to enable PAM support (i.e. --with-pam), this parameter will control whether or not Samba should obey PAM’s account and session management directives. The default behavior is to use PAM for clear text authentication only and to ignore any account or session management. Note that Samba always ignores PAM for authentication in the case of encrypt passwords = yes. The reason is that PAM modules cannot support the challenge/response authentication mechanism needed in the presence of SMB password encryption.

缺 省 设 置 : obey pam restrictions = no

only guest (S)

与 guest only同 义 .

only user (S)

此 布 尔 量 选 项 控 制 是 否 允 许 当 前 进 行 联 接 所 用 的 用 户 名 没 有 列 在 user列 表 中 .缺 省 情 况 下 此 项 是 被 禁 止 了 ,这 样 用 户 只 要 提 供 服 务 需 要 的 用 户 名 就 可 以 了 .设 置 这 个 选 项 将 强 制 服 务 器 使 用 user列 表 中 的 登 录 用 户 名 ， 这 只 在 共 享 级 安 全 中 有 效 。

要 注 意 的 是 上 面 的 说 法 也 表 明 了 samba并 不 会 从 服 务 名 而 推 演 出 相 应 的 用 户 名 .这 样 的 话 对 于 [homes]段 就 比 较 麻 烦 了 .要 避 免 麻 烦 的 话 需 要 用 user = %S,这 句 就 表 明 你 的 用 户 列 表 user正 好 就 是 这 个 服 务 资 源 名 ,这 时 的 主 目 录 名 就 是 用 户 名 .

参 见 user 选 项 。

缺 省 设 置 : only user = no

oplock break wait time (G)

此 项 调 整 性 的 选 项 以 适 应 在 Windows 9x和 WinNT中 可 能 出 现 的 错 误 .当 用 户 发 起 一 个 会 导 致 oplock暂 停 请 求 (oplock break request)的 SMB对 话 时 ,如 果 samba对 其 响 应 太 快 的 话 ,客 户 端 将 会 失 败 并 且 不 能 响 应 此 请 求 .这 个 可 调 整 的 选 项 (以 毫 秒 为 单 位 )是 一 个 samba在 向 这 样 的 客 户 发 送 oplock暂 停 请 求 前 等 待 的 时 间 量 .

除 非 你 理 解 了 samba的 oplock代 码 ,否 则 不 要 改 变 这 个 选 项 ！

缺 省 设 置 : oplock break wait time = 0

oplock contention limit (S)

这 是 个 非 常 高 级 的 smbd(8)调 整 选 项 ,用 以 改 进 在 多 个 用 户 争 夺 相 同 文 件 时 oplocks认 可 操 作 的 效 率 .

简 单 地 说 ， 这 个 选 项 指 定 了 一 个 数 字 ,如 果 争 夺 相 同 文 件 的 用 户 数 量 超 过 了 此 设 定 极 限 的 话 ， 即 使 有 请 求 ， smbd(8)也 不 再 认 可 oplock的 操 作 了 .这 样 的 话 smbd就 象 Windows NT一 样 的 运 行 .

除 非 你 理 解 了 samba的 oplock代 码 ,否 则 不 要 改 变 这 个 选 项 !

缺 省 设 置 : oplock contention limit = 2

oplocks (S)

此 布 尔 量 通 知 smbd是 否 对 当 前 请 求 的 共 享 资 源 上 的 文 件 打 开 操 作 启 用 oplocks(机 会 性 的 锁 定 操 作 ).oplock代 码 可 以 明 显 改 善 访 问 samba服 务 器 文 件 的 速 度 (approx.30% 甚 至 更 多 ).它 允 许 本 地 缓 存 文 件 ,对 于 不 可 信 赖 的 网 络 环 境 来 说 可 能 需 要 禁 止 掉 这 个 选 项 (在 Windows NT服 务 器 上 它 是 缺 省 打 开 的 ).请 参 考 samba docs/目 录 下 的 Speed.txt文 件 .

oplocks会 有 选 择 性 地 关 闭 每 一 个 基 本 共 享 资 源 上 的 特 定 文 件 .参 见 veto oplock files 选 项 .在 有 些 系 统 上 会 通 过 最 底 层 的 操 作 系 统 确 认 oplocks.这 样 就 可 以 在 所 有 的 访 问 与 oplocked文 件 中 进 行 数 据 同 步 ,而 不 管 此 访 问 是 通 过 samba或 NFS或 者 是 本 地 的 UNIX进 程 .参 见 kernel oplocks选 项 查 看 细 节 .

参 见 kernel oplocks 以 及 level2 oplocks parameters.

缺 省 设 置 : oplocks = yes

os2 driver map (G)

The parameter is used to define the absolute path to a file containing a mapping of Windows NT printer driver names to OS/2 printer driver names. The format is:

<nt driver name> = <os2 driver name>.<device name>

For example, a valid entry using the HP LaserJet 5 printer driver would appear as HP LaserJet 5L = LASERJET.HP LaserJet 5L.

The need for the file is due to the printer driver namespace problem described in ???. For more details on OS/2 clients, please refer to ???.

缺 省 设 置 : os2 driver map = <空 字 符 串 >

os level (G)

这 个 整 数 值 控 制 在 浏 览 器 选 举 中 Samba宣 布 它 本 身 是 什 么 系 统 级 别 . 此 选 项 的 值 决 定 了 nmbd(8是 否 有 机 会 成 为 本 地 广 播 区 域 内 工 作 组 WORKGROUP中 的 主 控 浏 览 器 .

注 意 : 默 认 情 况 下 ， Samba将 在 本 地 主 控 浏 览 器 选 举 中 超 越 所 有 M$操 作 系 统 并 且 获 胜 ， 除 非 还 有 Windows NT4.0/2000 域 控 制 器 。 这 意 味 着 Samba主 机 的 错 误 配 置 将 使 一 个 子 网 的 浏 览 无 效 。 参 见 Samba docs/ 目 录 中 的 BROWSING.txt 来 获 取 详 细 信 息 。

缺 省 设 置 : os level = 20

示 例 : os level = 65

pam password change (G)

With the addition of better PAM support in Samba 2.2, this parameter, it is possible to use PAM’s password change control flag for Samba. If enabled, then PAM will be used for password changes when requested by an SMB client instead of the program listed in passwd program. It should be possible to enable this without changing your passwd chat parameter for most setups.

缺 省 设 置 : pam password change = no

panic action (G)

此 项 是 一 个 samba开 发 者 使 用 的 选 项 以 允 许 当 smbd(8)或 smbd(8)程 序 崩 溃 时 可 以 调 用 一 个 系 统 命 令 .通 常 这 种 功 能 被 用 于 发 出 对 问 题 的 警 告 .

缺 省 设 置 : panic action = <空 字 符 串 >

示 例 : panic action = "/bin/sleep 90000"

paranoid server security (G)

Some version of NT 4.x allow non-guest users with a bad passowrd. When this option is enabled, samba will not use a broken NT 4.x server as password server, but instead complain to the logs and exit.

Disabling this option prevents Samba from making this check, which involves deliberatly attempting a bad logon to the remote server.

缺 省 设 置 : paranoid server security = yes

passdb backend (G)

This option allows the administrator to chose which backends to retrieve and store passwords with. This allows (for example) both smbpasswd and tdbsam to be used without a recompile. Multiple backends can be specified, separated by spaces. The backends will be searched in the order they are specified. New users are always added to the first backend specified.

This parameter is in two parts, the backend’s name, and a ’location’ string that has meaning only to that particular backed. These are separated by a : character.

Available backends can include: .TP 3 • smbpasswd - The default smbpasswd backend. Takes a path to the smbpasswd file as an optional argument. .TP • tdbsam - The TDB based password storage backend. Takes a path to the TDB as an optional argument (defaults to passdb.tdb in the private dir directory. .TP • ldapsam - The LDAP based passdb backend. Takes an LDAP URL as an optional argument (defaults to ldap://localhost) LDAP connections should be secured where possible. This may be done using either Start-TLS (see ldap ssl) or by specifying ldaps:// in the URL argument. .TP • nisplussam - The NIS+ based passdb backend. Takes name NIS domain as an optional argument. Only works with sun NIS+ servers. .TP • mysql - The MySQL based passdb backend. Takes an identifier as argument. Read the Samba HOWTO Collection for configuration details. .LP

缺 省 设 置 : passdb backend = smbpasswd

示 例 : passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd

示 例 : passdb backend = ldapsam:ldaps://ldap.example.com

示 例 : passdb backend = mysql:my_plugin_args tdbsam

passwd chat (G)

这 个 字 串 控 制 在 smbd(8)和 本 地 口 令 更 改 程 序 间 更 用 户 口 令 时 发 生 的 "chat"对 话 .字 符 串 描 述 一 个 应 答 接 收 对 的 序 列 ,让 smbd(8)用 于 决 定 对 passwd program发 送 并 等 待 接 收 哪 些 具 体 的 内 容 .如 果 没 有 收 到 预 计 的 输 出 时 不 会 更 改 口 令 .

这 个 chat序 列 一 般 发 生 在 特 定 的 主 机 上 ， 取 决 于 本 地 口 令 控 制 的 方 法 (就 象 NIS或 者 别 的 ).

注 意 这 个 选 项 仅 仅 在 unix password sync选 项 设 置 为 yes的 时 候 有 用 。 当 smbpasswd文 件 中 的 SMB口 令 被 更 改 时 是 以 root身 份 运 行 的 ， 不 必 输 入 旧 密 码 文 本 . 这 意 味 着 root必 须 可 以 在 不 知 道 用 户 密 码 时 重 置 他 的 密 码 。 在 NIS/YP 中 这 意 味 着 passwd程 序 必 须 在 NIS主 控 服 务 器 上 运 行 。

这 个 字 符 串 可 以 包 含 %n宏 ， 用 于 替 换 新 密 码 。 chat序 列 还 可 以 包 含 标 准 宏 \\n, \\r, \\t 和 \\s 来 给 出 换 行 ， 回 车 ， tab和 空 格 。 chat序 列 字 符 串 还 可 以 包 含 ’*’ 来 匹 配 任 何 字 符 序 列 。 双 引 号 用 来 将 带 空 格 的 字 符 串 设 为 一 个 单 独 的 字 符 串 。

如 果 在 对 话 序 列 的 任 何 部 分 发 送 的 字 符 串 为 一 个 句 号 ".",那 么 不 会 发 送 任 何 内 容 .同 样 ,如 果 等 待 接 收 部 分 有 字 符 串 是 一 个 ".",那 么 不 等 待 任 何 的 内 容 .

如 果 pam password change参 数 设 置 为 yes， chat可 以 以 任 何 顺 序 进 行 ， 没 有 特 定 的 输 出 ， 是 否 成 功 可 以 由 PAM结 果 得 到 。 在 PAM会 话 中 宏 \n被 忽 略 。

参 见 unix password sync, passwd program , passwd chat debug 和 pam password change.

缺 省 设 置 : passwd chat = *new*password* %n\n *new*password* %n\n *changed*

示 例 : passwd chat = "*Enter OLD password*" %o\n "*Enter NEW password*" %n\n "*Reenter NEW password*" %n\n "*Password changed*"

passwd chat debug (G)

此 布 尔 量 指 定 口 令 对 话 脚 本 选 项 是 否 以 debug模 式 运 行 .在 调 试 模 式 下 ,发 送 和 接 收 的 口 令 对 话 字 符 串 会 打 印 到 debug level为 100时 的 smbd(8)记 录 文 件 中 .由 于 在 smbd 记 录 中 允 许 使 用 明 文 口 令 ,所 以 这 是 个 危 险 的 选 项 .不 过 这 个 选 项 可 以 帮 助 Samba管 理 员 在 调 用 passwd program设 好 的 口 令 程 序 时 调 试 其 passwd chat 对 话 脚 本 ,并 且 应 该 在 完 成 以 后 把 它 关 闭 .这 个 选 项 在 设 置 了 pam password change选 项 时 无 效 。 缺 省 情 况 下 这 个 选 项 是 关 闭 的 .

参 见 passwd chat , pam password change , passwd program .

缺 省 设 置 : passwd chat debug = no

passwd program (G)

指 定 用 于 设 定 UNIX用 户 口 令 的 程 序 名 .出 现 %u的 地 方 表 示 以 用 户 名 替 换 .在 调 用 口 令 更 改 程 序 前 会 先 检 查 用 户 名 是 否 存 在 .

需 要 注 意 的 是 很 多 口 令 程 序 强 调 口 令 要 合 法 ,例 如 应 该 有 最 小 长 度 或 者 是 字 母 与 数 字 的 混 合 .这 可 能 在 一 些 客 户 端 (如 WfWg)总 将 口 令 转 为 大 写 发 送 时 ,引 起 一 些 问 题 .

注 意 如 果 把 unix password sync选 项 设 为 yes的 话 ,在 改 变 smbpasswd文 件 中 的 SMB口 令 时 是 以 root身 份 调 用 改 口 令 程 序 的 .如 果 口 令 更 改 失 败 的 话 ,smbd对 SMB口 令 的 更 改 也 会 失 败 ,这 是 设 计 时 的 机 制 .

如 果 设 定 了 unix password sync选 项 的 话 ,指 定 口 令 程 序 时 必 须 使 用 所 有 程 序 的 绝 对 路 径 ,必 须 检 查 安 全 问 题 .缺 省 的 unix password sync选 项 值 是 no.

参 见 unix password sync.

缺 省 设 置 : passwd program = /bin/passwd

示 例 : passwd program = /sbin/npasswd %u

password level (G)

在 一 些 客 户 端 /服 务 器 群 体 中 使 用 大 小 写 混 合 口 令 存 在 着 困 难 .其 中 比 较 麻 烦 的 一 类 客 户 是 WfWg,因 为 它 在 使 用 LANMAN1协 议 时 出 于 某 些 理 由 而 强 调 要 使 用 大 写 口 令 .不 过 当 使 用 COREPLUS时 不 要 修 改 它 ! 另 外 在 Windows95/98 操 作 系 统 中 会 出 问 题 : 即 使 选 择 了 会 话 中 的 NTLM0.12协 议 ， 这 些 客 户 端 也 会 将 明 文 口 令 转 为 大 写 。

此 选 项 定 义 了 口 令 字 中 大 写 字 母 的 最 大 数 量 .

例 如 ,假 定 给 出 的 口 令 是 "FRED".如 果 password level设 为 1的 话 ,在 "FRED"验 证 失 败 时 会 尝 试 以 下 的 口 令 组 合 ：

"Fred", "fred", "fRed", "frEd","freD"

如 果 password level设 为 2的 话 ,就 会 尝 试 下 面 的 组 合 ：

"FRed", "FrEd", "FreD", "fREd", "fReD", "frED", ..

等 等 。

把 此 选 项 设 成 的 值 越 高 ， 相 对 单 一 大 小 写 口 令 来 说 大 小 写 混 合 的 口 令 越 容 易 匹 配 。 .不 过 ,要 小 心 使 用 这 个 选 项 会 降 低 安 全 性 ,同 时 增 加 处 理 新 联 接 所 花 的 时 间 量 .

如 果 把 选 项 设 为 0时 会 使 处 理 口 令 时 只 作 两 种 尝 试 - 先 与 给 出 的 口 令 比 较 ,再 比 较 它 的 全 部 小 写 形 式 .

缺 省 设 置 : password level = 0

示 例 : password level = 4

password server (G)

通 过 在 这 里 指 定 其 它 的 SMB服 务 器 或 者 活 动 目 录 域 控 制 器 ,同 时 使 用 security = [ads|domain|server],能 把 联 接 samba的 用 户 名 /口 令 合 法 性 验 证 交 给 指 定 的 远 程 服 务 器 去 干 .

此 选 项 设 定 上 面 所 说 的 其 它 口 令 服 务 器 的 名 字 或 者 IP地 址 . 新 的 语 法 允 许 在 连 接 到 ADS realm服 务 器 时 指 定 端 口 号 。 要 指 定 默 认 的 LDAP 389端 口 之 外 的 号 码 ， 可 以 将 端 口 号 放 在 名 字 或 ip后 面 ， 中 间 用 一 个 冒 号 连 接 (比 如 说 ， 192.168.1.100:389)。 如 果 你 不 指 定 一 个 端 口 ， Samba将 使 用 标 准 的 LDAP端 口 tcp/389. 注 意 端 口 号 在 WindowsNT4.0 域 或 者 netbios连 接 的 服 务 器 上 无 效

如 果 参 数 是 一 个 名 称 ， 它 将 使 用 name resolve order 中 指 定 的 方 式 来 解 析 。

口 令 服 务 器 应 该 是 使 用 "LM1.2X002"或 "LM NT 0.12"协 议 的 主 机 ,而 且 它 本 身 必 须 使 用 用 户 级 安 全 模 式 .

注 意 ： 使 用 口 令 服 务 器 表 明 你 的 UNIX主 机 (就 是 运 行 Samba的 那 台 )就 只 与 你 指 定 的 口 令 服 务 器 具 有 相 同 的 安 全 等 级 了 .在 没 有 完 全 信 任 的 情 况 下 不 要 选 择 使 用 其 它 的 口 令 服 务 器 .

不 要 把 口 令 服 务 指 向 Samba服 务 器 本 身 ,这 产 生 一 个 循 环 而 去 查 找 你 的 Samba服 务 器 ,导 致 死 锁 .

在 指 定 口 令 服 务 器 名 时 可 以 使 用 标 准 的 替 换 符 ,而 实 际 能 用 的 可 能 只 是 %m这 一 个 ,这 个 替 换 符 说 明 Samba服 务 器 会 用 联 入 的 客 户 作 为 口 令 服 务 器 .如 果 这 样 用 的 话 说 明 你 非 常 信 任 你 的 客 户 ,同 时 最 好 以 主 机 允 许 策 略 对 他 们 进 行 限 制 ！

如 果 把 安 全 级 security选 项 设 为 domain或 者 ads的 话 ,指 定 的 其 它 口 令 服 务 器 必 须 是 在 这 个 Domain中 的 一 个 主 域 控 制 器 或 备 份 域 控 制 器 或 者 ’*’.另 外 指 定 字 符 ’*’的 话 就 以 samba服 务 器 会 在 整 个 域 中 使 用 加 密 验 证 RPC调 用 来 验 证 用 户 登 录 .使 用 security = domain的 好 处 是 ,如 果 指 定 了 几 个 password server时 ,smbd 会 对 每 一 个 进 行 尝 试 直 到 它 收 到 回 应 ,对 于 初 始 服 务 器 当 机 时 这 就 很 有 用 了 .

如 果 password server选 项 设 为 字 符 ’*’的 话 ,samba将 尝 试 通 过 查 询 WORKGROUP<1C>名 字 来 自 动 查 找 主 或 者 备 份 域 控 制 器 并 联 系 经 过 名 字 解 析 得 到 的 IP地 址 列 表 中 的 每 个 服 务 器 来 进 行 用 户 验 证 .

如 果 服 务 器 列 表 包 含 名 字 或 IP同 时 也 包 含 ’*’时 ， 列 表 将 视 为 首 选 域 控 制 器 的 列 表 ， 但 是 也 会 添 加 一 个 自 动 的 对 所 有 其 余 DC的 查 找 。 Samba不 会 通 过 定 位 最 近 的 DC来 优 化 这 张 列 表 。

如 果 security是 server的 话 ,会 有 一 些 安 全 级 为 security = domain时 所 没 有 的 限 制 ：

如 果 在 password server选 项 中 指 定 了 几 个 口 令 服 务 器 的 话 ,smbd在 联 接 具 体 的 服 务 器 时 会 失 败 ,也 不 能 验 证 任 何 的 用 户 账 号 .这 是 安 全 级 为 security = server 模 式 时 SMB/CIFS协 议 的 一 个 限 制 ,并 且 Samba无 法 修 改 .

如 果 把 Windows NT服 务 器 作 为 口 令 服 务 器 ,你 必 须 确 保 用 户 可 以 从 Samba服 务 器 上 进 行 登 录 .当 使 用 security = server模 式 时 ,网 络 登 录 看 起 来 是 从 那 里 处 理 的 ,而 不 是 从 用 户 工 作 站 .

参 见 security 选 项 。

缺 省 设 置 : password server = <空 字 符 串 >

示 例 : password server = NT-PDC, NT-BDC1, NT-BDC2, *

示 例 : password server = windc.mydomain.com:389 192.168.1.101 *

示 例 : password server = *

path (S)

此 项 指 定 给 出 的 服 务 项 所 用 的 系 统 路 径 .在 服 务 项 具 有 可 打 印 属 性 时 ,打 印 假 脱 机 数 据 会 先 存 放 在 这 个 路 径 所 指 的 位 置 中 . This parameter specifies a directory to which the user of the service is to be given access. In the case of printable services, this is where print data will spool prior to being submitted to the host for printing.

对 于 那 些 要 对 访 客 提 供 的 可 打 印 服 务 来 说 ,服 务 项 应 该 设 为 只 读 ,而 且 路 径 应 该 设 为 全 局 可 写 属 性 并 具 有 粘 性 (s)位 .这 当 然 不 是 强 制 性 的 ,不 过 不 这 样 做 的 话 可 能 会 无 法 得 到 你 所 希 望 的 结 果 .

路 径 出 现 %u的 地 方 将 以 正 处 于 联 接 状 态 的 UNIX用 户 名 来 替 换 ； 同 样 出 现 %m的 地 方 将 以 请 求 联 接 的 主 机 NetBIOS名 替 换 .在 设 定 伪 主 目 录 时 ,这 种 替 换 项 很 有 用 的 .

所 指 定 的 路 径 都 是 基 于 根 目 录 root dir(如 果 有 的 话 )的 .

缺 省 设 置 : 无

示 例 : path = /home/fred

pid directory (G)

This option specifies the directory where pid files will be placed.

缺 省 设 置 : pid directory = ${prefix}/var/locks

示 例 : pid directory = /var/run/

posix locking (S)

The smbd(8) daemon maintains an database of file locks obtained by SMB clients. The default behavior is to map this internal database to POSIX locks. This means that file locks obtained by SMB clients are consistent with those seen by POSIX compliant applications accessing the files via a non-SMB method (e.g. NFS or local file access). You should never need to disable this 选 项 。

缺 省 设 置 : posix locking = yes

postexec (S)

此 项 指 定 在 断 开 服 务 时 运 行 的 一 个 命 令 .它 使 用 通 常 的 替 换 项 .此 命 令 在 一 些 系 统 中 可 能 是 以 root身 份 来 运 行 的 .

一 个 有 趣 的 示 例 ， 用 于 卸 载 服 务 器 资 源 ：

postexec = /etc/umount /cdrom

参 见 preexec.

缺 省 设 置 : 无 (不 执 行 命 令 )

示 例 : postexec = echo

preexec (S)

此 项 指 定 在 联 接 到 服 务 时 运 行 一 个 命 令 .通 常 这 也 可 以 用 一 些 替 换 项 .

一 个 有 趣 的 示 例 ， 在 用 户 每 一 次 登 录 时 向 对 方 发 送 一 个 欢 迎 信 息 ： (一 条 格 言 ？ )

preexec = csh -c ’echo

当 然 ,一 段 时 间 以 后 这 类 信 息 可 能 就 比 较 讨 厌 了 :-)

参 见 preexec close 和 postexec .

缺 省 设 置 : 无 (不 执 行 命 令 )

示 例 : preexec = echo

preexec close (S)

此 布 尔 量 选 项 控 制 是 否 从 preexec 返 回 的 非 零 代 码 会 关 闭 所 联 接 的 服 务 .

缺 省 设 置 : preexec close = no

prefered master (G)

这 是 为 拼 写 错 误 准 备 的 。 请 查 看 preferred master :-)

preferred master (G)

此 布 尔 量 选 项 控 制 nmbd(8)是 否 作 为 工 作 组 里 的 首 选 主 浏 览 器 .

如 果 设 此 选 项 为 yes时 ,nmbd会 在 启 动 时 强 制 进 行 一 次 选 举 ,它 有 一 些 有 利 条 件 来 赢 得 选 举 .推 荐 把 此 选 项 与 domain master = yes联 合 使 用 ,这 样 nmbd可 以 保 证 成 为 一 个 域 浏 览 器 .

小 心 使 用 此 项 ,因 为 如 果 在 相 同 的 子 网 内 有 多 个 主 机 (不 管 是 Samba服 务 器 ， Windows95还 是 NT)参 加 选 举 的 话 ,他 们 每 个 都 会 周 期 性 不 断 地 尝 试 成 为 本 地 主 浏 览 器 ,这 时 会 造 成 不 必 须 的 广 播 交 通 流 量 并 降 低 浏 览 性 能 .

参 见 os level.

缺 省 设 置 : preferred master = auto

preload (G)

此 选 项 定 义 了 要 自 动 加 入 到 浏 览 列 表 的 服 务 项 清 单 .这 对 于 homes和 printers服 务 项 非 常 有 用 ,否 则 这 些 服 务 将 是 不 可 见 的 .

注 意 ,如 果 你 想 加 载 printcap里 所 有 的 打 印 机 ,那 么 用 load printers会 更 容 易 .

缺 省 设 置 : no preloaded services

示 例 : preload = fred lp colorlp

preload modules (G)

This is a list of paths to modules that should be loaded into smbd before a client connects. This improves the speed of smbd when reacting to new connections somewhat.

缺 省 设 置 : preload modules =

示 例 : preload modules = /usr/lib/samba/passdb/mysql.so+++

preserve case (S)

此 项 控 制 建 立 新 的 文 件 时 取 名 是 否 使 用 用 户 传 递 的 大 小 写 ,还 是 强 制 使 用 default case .

缺 省 设 置 : preserve case = yes

参 见 NAME MANGLING段 中 的 完 整 讨 论 .

printable (S)

如 果 此 项 设 为 yes,那 么 用 户 可 以 读 写 并 发 送 打 印 缓 存 文 件 到 服 务 项 指 定 的 目 录 中 .

注 意 一 个 可 打 印 的 服 务 总 是 允 许 通 过 缓 存 打 印 数 据 的 方 法 向 服 务 项 路 径 中 执 行 写 操 作 (需 要 用 户 有 可 写 权 限 ).read only选 项 控 制 只 允 许 不 可 打 印 地 访 问 资 源 .

缺 省 设 置 : printable = no

printcap (G)

与 printcap name 同 义 .

printcap name (S)

此 项 用 于 覆 盖 掉 编 译 时 产 生 的 缺 省 printcap名 (通 常 是 /etc/printcap).参 见 [printers]段 的 讨 论 ,它 说 明 了 为 什 么 要 这 样 做 的 理 由 .

To use the CUPS printing interface set printcap name = cups . This should be supplemented by an addtional setting printing = cups in the [global] section. printcap name = cups will use the "dummy" printcap created by CUPS, as specified in your CUPS configuration file.

在 可 以 用 lpstat命 令 列 出 可 用 打 印 机 的 列 表 的 System V系 统 上 ,可 以 用 printcap name = lpstat 来 自 动 获 得 可 用 打 印 机 列 表 .这 对 于 配 置 samba时 定 义 成 SYSV的 系 统 (这 就 包 括 了 很 多 基 于 System V的 系 统 )来 说 是 缺 省 情 况 .如 果 在 这 些 系 统 上 设 好 printcap name为 lpstat的 话 ,samba就 会 执 行 lpstat -v并 尝 试 分 析 输 出 信 息 以 获 得 一 份 打 印 机 列 表 .

通 常 最 小 的 printcap文 件 看 起 来 就 象 下 面 这 样 ：

print1|My Printer 1
print2|My Printer 2
print3|My Printer 3
print4|My Printer 4
print5|My Printer 5

我 们 看 到 ’|’符 号 用 来 定 义 打 印 机 的 别 名 .第 二 个 带 有 空 格 的 别 名 其 实 是 提 示 Samba它 是 注 释 .

在 AIX中 默 认 的 printcap文 件 名 是 /etc/qconfig. 如 果 在 文 件 名 中 找 到 qconfig字 样 ， Samba将 假 定 文 件 是 AIX 的 qconfig格 式 。

缺 省 设 置 : printcap name = /etc/printcap

示 例 : printcap name = /etc/myprintcap

print command (S)

当 一 个 打 印 作 业 完 全 缓 冲 到 了 服 务 项 时 ,此 项 指 定 的 命 令 就 能 过 调 用 system()来 处 理 那 些 缓 存 文 件 .通 常 我 们 指 定 典 型 的 命 令 来 发 送 缓 存 文 件 到 主 机 的 打 印 子 系 统 ,不 过 也 不 一 定 要 这 样 .服 务 器 不 会 删 除 那 些 缓 存 文 件 ,所 以 你 指 定 的 任 何 命 令 都 应 当 在 处 理 完 以 后 删 除 文 件 ,否 则 的 话 就 需 要 手 工 来 删 除 旧 的 缓 存 文 件 了 .

打 印 命 令 是 一 个 简 单 的 文 本 字 符 串 。 它 可 以 在 宏 替 换 之 后 逐 字 传 递 给 系 统 。

%s, %f - 缓 冲 文 件 名 路 径

%p - 适 当 的 打 印 机 名

%J - 客 户 提 交 的 作 业 名

%c - 缓 冲 的 作 业 需 要 打 印 的 页 数

%z -缓 冲 的 打 印 作 业 的 大 小 (以 字 节 计 )

打 印 命 令 至 少 必 须 包 含 %s或 %f替 换 符 中 的 一 个 ,而 %p是 个 可 选 项 .在 提 交 打 印 作 业 时 ,如 果 不 提 供 打 印 机 名 的 话 ,%p替 换 符 会 从 打 印 命 令 中 删 掉 .

如 果 在 [global]段 中 指 定 了 打 印 命 令 ,它 将 被 用 于 任 何 可 打 印 性 的 服 务 项 ,而 不 再 需 要 在 它 们 之 中 单 独 指 定 了 .

如 果 既 没 有 对 可 打 印 性 服 务 项 单 独 指 定 打 印 命 令 又 没 有 指 定 一 个 全 局 的 打 印 命 令 时 ,假 脱 机 文 件 虽 然 会 建 立 却 不 会 被 处 理 也 不 会 被 删 除 (这 很 重 要 哦 ).

注 意 在 某 些 UNIX上 以 nobody账 号 身 份 进 行 打 印 会 导 致 失 败 .如 果 发 生 了 这 样 的 情 况 请 建 立 一 个 单 独 的 有 打 印 权 的 访 客 账 号 并 在 [global]段 里 设 置 guest account选 项 .

如 果 你 明 白 命 令 是 直 接 传 递 给 shell的 话 ， 你 可 以 组 织 非 常 复 杂 的 打 印 命 令 .举 例 来 说 ,下 面 的 命 令 会 记 录 一 个 打 印 作 业 ,打 印 这 个 文 件 然 后 删 掉 它 .注 意 这 里 的 ’;’是 shell脚 本 命 令 常 用 的 分 隔 符 .

print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s

你 可 能 必 须 根 据 平 时 在 系 统 上 打 印 文 件 的 方 式 来 改 变 这 个 命 令 .缺 省 情 况 下 ,此 选 项 会 根 据 printing选 项 的 设 定 而 变 化 .

缺 省 设 置 : 对 于 printing = BSD, AIX, QNX, LPRNG 或 者 PLP :

print command = lpr -r -P%p %s

对 于 printing = SYSV 或 者 HPUX :

print command = lp -c -d%p %s; rm %s

对 于 printing = SOFTQ :

print command = lp -d%p -s %s; rm %s

对 于 printing = CUPS :

如 果 Samba 编 译 时 加 入 了 libcups, 那 么 printcap=cups将 使 用 CUPS API来 提 交 作 业 等 等 。 否 则 它 用 -oraw选 项 ， 使 用 SystemV命 令 来 打 印 ， 也 就 是 说 它 会 用 lp -c -d%p -o raw; rm %s.当 printing = cups, 并 且 Samba编 译 时 加 入 了 libcups时 ， 任 何 手 工 设 置 的 打 印 命 令 将 被 忽 略 。

示 例 : print command = /usr/local/samba/bin/myprintscript %p %s

printer (S)

与 printer name 同 义 。

printer admin (S)

This is a list of users that can do anything to printers via the remote administration interfaces offered by MS-RPC (usually using a NT workstation). Note that the root user always has admin rights.

缺 省 设 置 : printer admin = <空 字 符 串 >

示 例 : printer admin = admin, @staff

printer name (S)

此 选 项 指 定 可 打 印 性 服 务 项 用 来 打 印 缓 存 作 业 数 据 的 打 印 机 .

如 果 在 [global]段 里 指 定 了 打 印 机 名 称 ,那 么 给 出 的 打 印 机 就 用 于 任 何 可 打 印 性 服 务 项 而 不 需 个 别 的 指 定 打 印 机 名 称 了 .

缺 省 设 置 : 空 (在 很 多 系 统 中 可 能 是 lp )

示 例 : printer name = laserwriter

printing (S)

此 选 项 控 制 系 统 上 如 何 解 释 打 印 机 状 态 信 息 ,而 如 果 在 [global]段 中 定 义 ， 它 也 会 影 响 print command,lpq command,lppause command,lpresume command和 lprm command这 些 选 项 的 缺 省 值

通 常 系 统 支 持 九 种 打 印 机 风 格 ,它 们 是 BSD, AIX, LPRNG, PLP, SYSV, HPUX, QNX, SOFTQ,还 有 CUPS

要 在 系 统 上 查 看 使 用 了 不 同 的 选 项 后 其 它 打 印 命 令 的 缺 省 值 ,可 以 用 testparm(1)程 序 .

此 项 可 以 在 每 一 台 打 印 机 上 分 别 设 置 .

参 见 [printers]段 的 讨 论 。

print ok (S)

与 printable 同 义 。

private dir (G)

This parameters defines the directory smbd will use for storing such files as smbpasswd and secrets.tdb.

Default :private dir = ${prefix}/private

profile acls (S)

This boolean parameter controls whether smbd(8) This boolean parameter was added to fix the problems that people have been having with storing user profiles on Samba shares from Windows 2000 or Windows XP clients. New versions of Windows 2000 or Windows XP service packs do security ACL checking on the owner and ability to write of the profile directory stored on a local workstation when copied from a Samba share.

When not in domain mode with winbindd then the security info copied onto the local workstation has no meaning to the logged in user (SID) on that workstation so the profile storing fails. Adding this parameter onto a share used for profile storage changes two things about the returned Windows ACL. Firstly it changes the owner and group owner of all reported files and directories to be BUILTIN\\Administrators, BUILTIN\\Users respectively (SIDs S-1-5-32-544, S-1-5-32-545). Secondly it adds an ACE entry of "Full Control" to the SID BUILTIN\\Users to every returned ACL. This will allow any Windows 2000 or XP workstation user to access the profile.

Note that if you have multiple users logging on to a workstation then in order to prevent them from being able to access each others profiles you must remove the "Bypass traverse checking" advanced user right. This will prevent access to other users profile directories as the top level profile directory (named after the user) is created by the workstation profile code and has an ACL restricting entry to the directory tree to the owning user.

缺 省 设 置 : profile acls = no

protocol (G)

与 max protocol 同 义

public (S)

与 guest ok 同 义

queuepause command (S)

定 义 服 务 器 暂 停 打 印 队 列 时 要 执 行 的 命 令 .

此 命 令 应 该 是 个 只 用 打 印 机 名 作 为 选 项 的 程 序 或 脚 本 ,以 便 用 来 停 止 打 印 队 列 ,使 打 印 作 业 不 再 向 打 印 机 发 送 .

此 命 令 不 支 持 Windows for Workgroups,但 可 以 在 Windows 95和 NT的 打 印 机 窗 口 中 发 送 .

此 处 用 替 换 符 %p可 以 替 代 打 印 机 名 称 .否 则 这 个 名 称 将 被 放 置 在 命 令 后 面 .

注 意 ,在 命 令 中 使 用 绝 对 路 径 是 个 好 习 惯 ,因 为 不 一 定 可 以 获 得 服 务 器 的 PATH变 量 .

缺 省 设 置 : 依 赖 于 printing 选 项 的 设 置

示 例 : queuepause command = disable %p

queueresume command (S)

定 义 服 务 器 恢 复 暂 停 了 的 打 印 队 列 时 要 执 行 的 命 令 .就 是 用 于 恢 复 因 为 上 面 的 选 项 ( queuepause command)而 导 致 的 结 果 的 .

此 命 令 应 该 是 个 只 用 打 印 机 名 作 为 选 项 的 程 序 或 脚 本 ,以 便 用 来 恢 复 打 印 队 列 ,使 打 印 作 业 继 续 向 打 印 机 发 送 .

此 命 令 不 支 持 Windows for Workgroups,但 可 以 在 Windows 95和 NT的 打 印 机 窗 口 中 发 送 .

此 处 用 替 换 符 %p可 以 替 代 打 印 机 名 称 .否 则 这 个 名 称 将 被 放 置 在 命 令 后 面 .

注 意 ,在 命 令 中 使 用 绝 对 路 径 是 个 好 习 惯 ,因 为 不 一 定 可 以 获 得 服 务 器 的 PATH变 量 .

缺 省 设 置 : 依 赖 于 printing 选 项 的 设 置

示 例 : queuepause command = enable %p

read bmpx (G)

此 布 尔 量 选 项 控 制 是 否 让 smbd(8)支 持 "多 工 读 块 "(Read Block Multiplex)的 SMB.现 在 这 种 方 式 已 经 很 少 用 了 ,所 以 缺 省 是 no.一 般 你 不 需 要 设 定 此 选 项 .

缺 省 设 置 : read bmpx = no

read list (S)

此 处 给 出 对 服 务 项 有 只 读 权 限 的 用 户 清 单 .如 果 正 在 联 接 的 用 户 属 于 此 列 表 ,那 么 他 们 将 没 有 写 权 限 ,此 时 是 不 管 read only选 项 是 否 设 置 的 .此 列 表 可 以 包 括 用 在 invalid users 选 项 中 描 述 的 语 法 定 义 的 组 名 称 .

参 见 write list 和 invalid users 选 项 。

缺 省 设 置 : read list = <空 字 符 串 >

示 例 : read list = mary, @students

read only (S)

注 意 它 与 writeable 反 义 .

如 果 这 个 参 数 是 yes, 那 么 服 务 的 用 户 不 能 建 立 或 修 改 服 务 目 录 中 的 文 件 。

注 意 一 个 可 打 印 的 服 务 (printable = yes) 的 目 录 总 是 可 写 的 (需 要 用 户 可 写 权 限 )但 是 只 能 通 过 缓 冲 操 作 来 写 .

缺 省 设 置 : read only = yes

read raw (G)

此 选 项 控 制 着 是 否 让 服 务 器 在 传 送 数 据 到 客 户 端 时 支 持 读 取 原 始 的 SMB请 求 .

如 果 允 许 ,那 么 它 会 以 65535 字 节 为 单 位 来 读 取 一 个 数 据 包 的 65535字 节 .这 会 带 来 较 多 的 性 能 方 面 的 好 处 .

但 是 ,有 些 客 户 端 使 用 不 正 确 的 包 容 量 (虽 然 是 可 允 许 的 ),或 者 它 们 不 支 持 大 容 量 包 ,所 以 对 这 些 客 户 端 你 应 该 禁 止 这 一 选 项 .

通 常 将 此 选 项 作 为 一 种 系 统 调 试 工 具 ,而 且 严 格 来 说 不 应 修 改 .参 见 write raw选 项 .

缺 省 设 置 : read raw = yes

read size (G)

此 项 影 响 着 磁 盘 读 /写 与 网 络 读 /写 的 轮 流 交 替 .如 果 在 若 干 个 SMB命 令 (通 常 是 SMBwrite,SMBwriteX和 SMBreadbraw)中 传 送 的 数 据 量 超 过 此 项 设 定 的 值 时 ,服 务 器 开 始 就 会 在 从 网 络 接 收 整 个 数 据 包 之 前 进 行 写 操 作 ； 在 执 行 SMBreadbraw的 情 况 下 ,服 务 器 在 从 磁 盘 上 读 出 所 有 数 据 之 前 就 开 始 向 网 络 中 写 数 据 .

在 磁 盘 与 网 络 的 访 问 速 度 相 近 时 ,这 种 交 迭 式 的 工 作 就 会 做 得 非 常 好 ,不 过 当 其 中 一 类 设 备 的 速 度 大 大 高 于 另 一 类 时 ,它 只 会 有 那 么 一 点 点 效 果 .

缺 省 的 值 是 16384,但 没 有 做 过 测 试 最 优 值 的 实 验 。 根 据 已 经 了 解 的 情 况 来 看 ,在 使 用 不 同 的 系 统 时 ,最 优 化 值 的 差 别 很 大 .一 个 大 于 65536的 值 是 没 有 任 何 意 义 的 ,它 只 会 造 成 不 必 要 的 内 存 分 配 .

缺 省 设 置 : read size = 16384

示 例 : read size = 8192

realm (G)

This option specifies the kerberos realm to use. The realm is used as the ADS equivalent of the NT4 domain. It is usually set to the DNS name of the kerberos server.

缺 省 设 置 : realm =

示 例 : realm = mysambabox.mycompany.com

remote announce (G)

此 项 允 许 你 设 置 nmbd(8)周 期 性 地 向 任 意 工 作 组 的 任 意 IP地 址 申 明 自 己 的 存 在 .

如 果 你 要 samba服 务 器 处 在 一 个 通 常 浏 览 传 播 规 则 没 有 正 常 工 作 的 远 程 工 作 组 里 时 ,用 此 项 就 很 有 用 了 .此 远 程 工 作 组 可 以 位 于 IP包 到 得 到 的 任 何 地 方 .

例 如 :

remote announce = 192.168.2.255/SERVERS 192.168.4.255/STAFF

以 上 这 行 说 明 nmbd 对 两 个 给 出 的 使 用 工 作 组 名 的 IP地 址 进 行 申 明 .如 果 你 只 用 了 IP地 址 的 话 ,那 么 会 用 workgroup选 项 里 给 出 的 工 作 组 名 来 替 代 .

你 选 用 的 IP地 址 通 常 应 该 是 远 程 网 络 的 广 播 地 址 ,不 过 也 可 以 用 配 置 稳 定 的 网 络 中 的 已 知 主 浏 览 器 IP地 址 .

缺 省 设 置 : remote announce = <空 字 符 串 >

remote browse sync (G)

此 项 允 许 你 设 定 nmbd(8)周 期 性 地 同 步 位 于 远 程 (remote segment)的 Samba主 浏 览 器 上 的 浏 览 列 表 .同 时 也 允 许 你 收 集 位 于 具 有 交 叉 路 由 子 网 中 主 浏 览 器 上 的 浏 览 列 表 .这 是 以 一 种 和 其 他 非 Samba的 服 务 器 不 兼 容 的 方 式 进 行 的 。

This is useful if you want your Samba server and all local clients to appear in a remote workgroup for which the normal browse propagation rules don’t work. The remote workgroup can be anywhere that you can send IP packets to.

例 如 :

remote browse sync = 192.168.2.255 192.168.4.255

以 上 行 会 使 nmbd向 位 于 指 定 子 网 或 地 址 中 的 主 浏 览 器 请 求 同 步 他 们 本 地 服 务 器 中 的 浏 览 列 表

你 选 用 的 IP地 址 通 常 应 该 是 远 程 网 络 的 广 播 地 址 ,不 过 也 可 以 用 配 置 非 常 稳 定 的 网 络 中 的 已 知 主 浏 览 器 IP地 址 .如 果 给 出 一 个 主 机 的 IP地 址 ,或 者 主 控 浏 览 器 事 实 上 在 自 己 的 网 段 中 , samba就 不 验 证 远 程 主 机 是 否 有 效 、 是 否 正 在 侦 听 了 。

缺 省 设 置 : remote browse sync = <空 字 符 串 >

restrict anonymous (G)

这 个 选 项 限 制 了 是 否 在 匿 名 连 接 中 返 回 用 户 和 组 列 表 信 息 ， 仿 照 了 Windows2000 和 NT在 注 册 表 键 值 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\LSA\RestrictAnonymous 中 的 做 法 。 设 置 为 0的 时 候 ， 任 何 请 求 都 返 回 用 户 和 组 列 表 。 设 置 为 1的 时 候 ， 只 有 认 证 的 用 户 可 以 获 得 用 户 和 组 列 表 。 设 置 为 2的 时 候 ， 只 有 Windows2000/XP和 Samba支 持 ， 不 允 许 匿 名 连 接 。 这 样 做 会 阻 止 需 要 匿 名 操 作 的 M$或 第 三 方 程 序 运 行 。

The security advantage of using restrict anonymous = 1 is dubious, as user and group list information can be obtained using other means.

The security advantage of using restrict anonymous = 2 is removed by setting guest ok = yes on any share.

缺 省 设 置 : restrict anonymous = 0

root (G)

与 root directory" 同 义

root dir (G)

与 root directory" 同 义 .

root directory (G)

服 务 器 将 在 启 动 时 对 此 项 所 设 之 目 录 进 行 chroot()(也 就 是 改 变 根 目 录 ) 操 作 .对 于 安 全 操 作 来 说 ,这 并 不 是 十 分 必 要 的 .如 果 没 有 这 步 操 作 ,服 务 器 会 拒 绝 对 服 务 项 以 外 的 文 件 进 行 访 问 .同 时 也 检 查 并 拒 绝 那 些 文 件 系 统 其 它 部 分 的 软 链 接 或 者 尝 试 在 其 它 目 录 (取 决 于 选 项 wide links的 设 置 情 况 )中 使 用 ".."这 些 操 作 .

加 入 一 个 root directory,注 意 不 是 实 际 的 "/"目 录 ,可 以 增 加 额 外 的 安 全 级 别 ,但 是 代 价 就 高 了 .这 样 完 全 确 保 了 所 指 定 的 root directory及 所 属 子 目 录 外 的 文 件 都 是 不 能 访 问 的 ,包 括 服 务 器 正 常 运 行 时 所 需 的 一 些 文 件 也 是 如 此 .因 此 要 想 维 护 服 务 器 整 体 的 可 操 作 性 ,你 需 要 镜 像 一 些 系 统 文 件 到 所 指 定 的 root directory下 .特 别 是 要 镜 像 /etc/passwd文 件 或 此 文 件 的 子 集 ,如 果 需 要 的 话 ,任 何 打 印 操 作 要 用 到 的 二 进 制 文 件 或 配 置 文 件 也 要 镜 像 .当 然 ,应 该 由 操 作 系 统 决 定 必 须 被 镜 像 的 文 件 集 合 .

缺 省 设 置 : root directory = /

示 例 : root directory = /homes/smb

root postexec (S)

此 项 与 postexec选 项 含 义 相 同 ,只 是 以 root身 份 来 运 行 命 令 而 已 .在 一 次 联 接 关 闭 之 后 对 文 件 系 统 ,特 别 是 光 盘 驱 动 器 进 行 卸 载 是 非 常 有 用 的 .

参 见 postexec.

缺 省 设 置 : root postexec = <空 字 符 串 >

root preexec (S)

此 项 与 preexec选 项 含 义 相 同 ,只 是 以 root身 份 来 运 行 命 令 而 已 .在 一 次 联 接 稳 定 建 立 之 后 装 载 文 件 系 统 ,特 别 是 光 盘 驱 动 器 是 非 常 有 用 的 .

参 见 preexec 和 preexec close 选 项 .

缺 省 设 置 : root preexec = <空 字 符 串 >

root preexec close (S)

此 项 与 preexec close 选 项 含 义 相 同 ,只 是 以 root身 份 来 运 行 命 令 而 已 .

参 见 preexec 和 preexec close.

缺 省 设 置 : root preexec close = no

security (G)

此 项 是 smb.conf文 件 中 最 重 要 的 一 个 设 定 之 一 ,它 影 响 了 客 户 是 如 何 应 答 Samba服 务 器 的 .

这 个 选 项 设 置 了 “安 全 模 式 位 ”用 于 答 复 协 议 协 商 以 使 smbd(8) 调 整 共 享 安 全 级 是 开 或 者 关 .客 户 端 根 据 此 位 决 定 是 否 (以 及 如 何 )向 服 务 器 传 送 用 户 和 口 令 信 息 .

缺 省 值 是 security = user,这 也 是 在 Windows 98和 Windows NT环 境 中 最 常 用 的 设 定 .

可 选 的 值 security = share, security = server 或 者 security = domain .

2.0.0版 本 之 前 的 Samba中 ,缺 省 值 是 security = share 主 要 因 为 当 时 只 有 这 一 个 值 可 选 。

在 WfWg里 有 一 个 错 误 ,当 在 使 用 用 户 和 服 务 器 安 全 级 时 ,WfWg客 户 将 会 完 全 忽 略 你 在 "connect drive"对 话 框 里 键 入 的 口 令 .这 就 使 除 了 在 WfWg里 已 登 录 的 用 户 以 外 的 任 何 人 要 联 接 Samba服 务 项 变 得 非 常 困 难 .

如 果 你 的 主 机 使 用 与 UNIX主 机 上 相 同 的 用 户 名 时 ,就 应 当 使 用 security = user.如 果 你 用 的 用 户 名 通 常 在 UNIX上 不 存 在 时 就 应 该 用 security = share.

如 果 你 想 设 置 共 享 而 不 用 口 令 的 话 (访 客 级 共 享 )也 应 该 用 security=share.这 通 常 用 于 提 供 共 享 打 印 的 服 务 器 .在 security=user里 设 定 guest帐 户 非 常 困 难 ,详 细 的 情 况 请 参 见 map to guest选 项 .

smbd可 能 会 使 用 一 种 混 杂 模 式 (hybrid),这 样 就 可 以 在 不 同 的 NetBIOS aliases下 提 供 用 户 和 共 享 级 的 安 全 特 性 .

现 在 解 释 各 个 不 同 的 设 定 .

SECURITY = SHARE

当 客 户 联 接 到 一 个 共 享 安 全 级 的 服 务 器 ,在 联 接 共 享 资 源 之 前 无 需 用 一 个 合 法 的 用 户 名 和 口 令 登 录 到 服 务 器 (虽 然 现 在 的 客 户 端 象 WIN95/95及 NT在 与 security = share 的 服 务 器 交 谈 时 都 会 以 用 户 名 发 送 一 个 登 录 请 求 ,但 却 没 有 带 口 令 ).相 反 ,客 户 端 会 在 每 一 个 共 享 上 发 送 认 证 信 息 (口 令 )以 尝 试 联 接 到 这 个 共 享 项 .

注 意 smbd 总 是 用 合 法 的 UNIX用 户 代 表 客 户 进 行 操 作 , 即 使 是 在 security = share 的 时 候 .

因 为 在 共 享 安 全 级 中 ,客 户 无 需 向 服 务 器 发 送 用 户 名 ,所 以 smbd用 一 些 技 术 来 为 客 户 决 定 正 确 的 UNIX用 户 账 号 .

用 于 匹 配 给 出 客 户 口 令 的 可 能 的 UNIX用 户 名 列 表 可 以 用 以 下 方 法 建 立 ：

如 果 设 置 了 guest only选 项 ,则 跳 过 所 有 其 它 步 骤 只 检 查 guest account用 户 名 .

如 果 通 过 共 享 连 接 请 求 发 送 一 个 用 户 名 ,则 此 用 户 名 (映 射 后 - 参 见 username map)被 作 为 潜 在 用 户 名 加 入 .

如 果 客 户 使 用 一 个 先 前 的 logon 请 求 (SessionSetup SMB调 用 )则 在 SMB中 发 送 的 用 户 名 将 作 为 潜 在 用 户 名 加 入 .

客 户 请 求 的 服 务 项 名 被 作 为 潜 在 用 户 名 加 入 .

客 户 的 NetBIOS名 被 作 为 潜 在 用 户 名 加 入 到 列 表 中 .

在 user列 表 中 的 任 何 用 户 都 被 作 为 潜 在 用 户 名 加 入 .

如 果 未 设 guest only选 项 ,则 使 用 提 供 的 口 令 来 尝 试 此 列 表 .对 于 匹 配 到 口 令 的 第 一 个 用 户 将 作 为 UNIX用 户 身 份 使 用 .

如 果 设 置 了 guest only选 项 或 未 检 测 到 用 户 名 ,则 如 果 共 享 项 中 标 志 为 可 以 使 用 guest account,那 么 使 用 此 访 客 用 户 账 号 ,否 则 拒 绝 访 问 .

注 意 ,在 共 享 安 全 级 中 关 于 哪 个 UNIX用 户 名 最 后 将 在 允 许 访 问 中 使 用 非 常 混 淆 .

参 见 NOTE ABOUT USERNAME/PASSWORD VALIDATION段 .

SECURITY = USER 这 是 samba2.0/3.0缺 省 安 全 级 设 置 .对 于 用 户 安 全 级 ,一 个 客 户 必 须 先 以 合 法 的 用 户 名 和 口 令 (也 可 以 用 username map选 项 进 程 映 射 )“登 录 ”.在 此 安 全 模 式 中 也 可 使 用 加 密 口 令 (参 见 encrypted passwords选 项 ).如 果 设 置 了 如 user和 guest only这 样 的 选 项 ,则 它 们 会 被 应 用 并 且 在 此 连 接 上 更 改 UNIX用 户 账 号 ,但 只 能 在 用 户 账 号 被 成 功 验 证 之 后 才 行 .

注 意 ,当 服 务 器 成 功 验 证 客 户 身 份 之 前 ,请 求 的 资 源 名 称 是 不 发 送 到 服 务 器 上 的 .这 就 是 为 什 么 用 户 安 全 级 中 在 没 有 允 许 服 务 器 自 动 把 未 知 用 户 映 射 为 guest account的 情 况 下 ,访 客 共 享 无 法 工 作 .参 见 map to guest选 项 获 得 完 成 映 射 的 细 节 .

参 见 NOTE ABOUT USERNAME/PASSWORD VALIDATION段 .

SECURITY = DOMAIN

只 有 已 经 用 net(8)把 服 务 器 添 加 进 一 个 Windows NT的 域 中 ,此 安 全 模 式 才 能 正 常 工 作 .它 要 求 encrypted passwords选 项 设 为 yes.在 此 模 式 中 Samba将 试 图 把 用 户 名 /口 令 传 送 到 一 个 WindowsNT主 域 或 备 份 域 控 制 器 进 行 验 证 像 一 台 真 正 的 WindowsNT服 务 器 那 样 。

注 意 ,仍 然 需 要 存 在 一 个 和 域 控 制 器 上 的 用 户 名 一 致 的 有 效 的 UNIX用 户 ， 来 使 Samba拥 有 一 个 有 效 的 UNIX帐 户 来 映 射 存 取 文 件 操 作 。

注 意 ,对 于 客 户 端 来 说 ,security=domain模 式 与 security=user是 一 样 的 .它 只 影 响 服 务 器 处 理 验 证 工 作 的 方 式 .对 于 客 户 端 无 任 何 影 响 .

注 意 ,当 服 务 器 成 功 验 证 客 户 身 份 之 前 ,请 求 的 资 源 名 称 是 不 发 送 到 服 务 器 上 的 .这 就 是 为 什 么 域 安 全 级 中 在 没 有 允 许 服 务 器 自 动 把 未 知 用 户 映 射 为 guest account的 情 况 下 ,访 客 共 享 无 法 工 作 .参 见 map to guest选 项 获 得 完 成 映 射 的 细 节

参 见 NOTE ABOUT USERNAME/PASSWORD VALIDATION 段 .

参 见 password server parameter 和 encrypted passwords 选 项 。

SECURITY = SERVER

在 此 模 式 中 Samba将 试 图 把 用 户 名 /口 令 传 送 到 其 它 SMB服 务 器 ,比 如 一 台 NT服 务 器 ,进 行 验 证 .如 果 验 证 失 败 则 回 到 security = user模 式 ,它 需 要 encrypted passwords 参 数 设 置 为 yes， 除 非 远 端 系 统 不 支 持 它 们 。 但 是 要 注 意 ， 如 果 使 用 了 加 密 口 令 的 话 ,samba不 会 再 去 检 查 UNIX系 统 口 令 文 件 的 ,它 必 须 有 一 个 合 法 的 smbpasswd文 件 以 再 次 检 查 用 户 账 号 .参 见 Samba HOWTO Collection 中 关 于 User Database 的 章 节 来 获 得 如 何 设 置 的 信 息 。

This mode of operation has significant pitfalls, due to the fact that is activly initiates a man-in-the-middle attack on the remote SMB server. In particular, this mode of operation can cause significant resource consuption on the PDC, as it must maintain an active connection for the duration of the user’s session. Furthermore, if this connection is lost, there is no way to reestablish it, and futher authenticaions to the Samba server may fail. (From a single client, till it disconnects).

注 意 ,对 于 客 户 端 来 说 ,security=server模 式 与 security=user是 一 样 的 .它 只 影 响 服 务 器 处 理 验 证 工 作 的 方 式 .对 于 客 户 端 无 任 何 影 响 .

注 意 ,当 服 务 器 成 功 验 证 客 户 身 份 之 前 ,请 求 的 资 源 名 称 是 不 发 送 到 服 务 器 上 的 .这 就 是 为 什 么 服 务 器 安 全 级 中 在 没 有 允 许 服 务 器 自 动 把 未 知 用 户 映 射 为 guest account的 情 况 下 ,访 客 共 享 无 法 工 作 .参 见 map to guest选 项 获 得 完 成 映 射 的 细 节 .

参 见 NOTE ABOUT USERNAME/PASSWORD VALIDATION 段 .

参 见 password server parameter 和 encrypted passwords 选 项 。

SECURITY = ADS

In this mode, Samba will act as a domain member in an ADS realm. To operate in this mode, the machine running Samba will need to have Kerberos installed and configured and Samba will need to be joined to the ADS realm using the net utility.

Note that this mode does NOT make Samba operate as a Active Directory Domain Controller.

Read the chapter about Domain Membership in the HOWTO for details.

参 见 ads server parameter, the realm paramter 和 encrypted passwords 选 项 。

缺 省 设 置 : security = USER

示 例 : security = DOMAIN

security mask (S)

此 选 项 控 制 NT客 户 用 本 地 NT安 全 对 话 框 操 作 UNIX权 限 时 对 权 限 所 作 的 修 改 情 况 . This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating the UNIX permission on a file using the native NT security dialog box.

此 选 项 用 掩 码 值 ’与 ’实 现 对 权 限 位 的 更 改 ,从 而 防 止 修 改 未 出 现 在 此 掩 码 中 的 任 何 位 .可 以 将 掩 码 中 的 0看 作 用 户 无 权 更 改 的 位 值 . This parameter is applied as a mask (AND’ed with) to the changed permission bits, thus preventing any bits not in this mask from being modified. Essentially, zero bits in this mask may be treated as a set of bits the user is not allowed to change.

如 未 明 确 设 定 此 选 项 ,则 把 此 选 项 设 为 0777， 允 许 用 户 修 改 文 件 的 所 有 user/group/world这 些 权 限 .

注 意 ,可 通 过 其 它 手 段 访 问 到 Samba服 务 器 的 用 户 可 以 轻 而 易 举 地 绕 过 此 限 制 ,所 以 此 选 项 只 对 独 立 的 服 务 器 系 统 有 用 .多 数 普 通 系 统 的 管 理 员 可 以 将 它 保 留 为 0777.

参 见 force directory security mode, directory security mask, force security mode 选 项 .

缺 省 设 置 : security mask = 0777

示 例 : security mask = 0770

server schannel (G)

This controls whether the server offers or even demands the use of the netlogon schannel. server schannel = no does not offer the schannel, server schannel = auto offers the schannel but does not enforce it, and server schannel = yes denies access if the client is not able to speak netlogon schannel. This is only the case for Windows NT4 before SP4.

Please note that with this set to no you will have to apply the WindowsXP requireSignOrSeal-Registry patch found in the docs/Registry subdirectory.

缺 省 设 置 : server schannel = auto

示 例 : server schannel = yes

server signing (G)

This controls whether the server offers or requires the client it talks to to use SMB signing. Possible values are auto, mandatory and disabled.

When set to auto, SMB signing is offered, but not enforced. When set to mandatory, SMB signing is required and if set to disabled, SMB signing is not offered either.

缺 省 设 置 : client signing = False

server string (G)

此 选 项 在 打 印 管 理 器 中 的 打 印 机 信 息 对 话 框 以 及 在 net view(网 上 邻 居 )的 IPC连 接 中 显 示 的 服 务 器 信 息 .它 可 以 是 任 何 你 希 望 向 用 户 显 示 的 字 串 .

它 还 设 置 显 示 在 浏 览 列 表 中 主 机 名 后 的 内 容 .

%v 将 替 换 为 Samba版 本 号

%h 将 替 换 为 主 机 名

缺 省 设 置 : server string = Samba %v

示 例 : server string = University of GNUs Samba Server

set directory (S)

如 果 set directory = no， 则 使 用 服 务 的 用 户 不 能 用 setdir命 令 更 变 目 录 .

setdir命 令 只 在 Digital Pathworks客 户 端 中 实 现 .参 见 Pathworks文 档 的 细 节 .

缺 省 设 置 : set directory = no

set primary group script (G)

Thanks to the Posix subsystem in NT a Windows User has a primary group in addition to the auxiliary groups. This script sets the primary group in the unix userdatase when an administrator sets the primary group from the windows user manager or when fetching a SAM with net rpc vampire. %u will be replaced with the user whose primary group is to be set. %g will be replaced with the group to set.

缺 省 设 置 : No default value

示 例 : set primary group script = /usr/sbin/usermod -g ’%g’ ’%u’

set quota command (G)

The set quota command should only be used whenever there is no operating system API available from the OS that samba can use.

This parameter should specify the path to a script that can set quota for the specified arguments.

The specified script should take the following arguments:

1 - quota type .TP 3 • 1 - user quotas .TP • 2 - user default quotas (uid = -1) .TP • 3 - group quotas .TP • 4 - group default quotas (gid = -1) .LP

2 - id (uid for user, gid for group, -1 if N/A)

3 - quota state (0 = disable, 1 = enable, 2 = enable and enforce)

4 - block softlimit

5 - block hardlimit

6 - inode softlimit

7 - inode hardlimit

8(optional) - block size, defaults to 1024

The script should output at least one line of data.

参 见 get quota command 选 项 。

缺 省 设 置 : set quota command =

示 例 : set quota command = /usr/local/sbin/set_quota

share modes (S)

此 选 项 在 一 个 文 件 打 开 时 允 许 或 禁 止 share modes.此 模 式 可 用 于 使 客 户 获 得 对 一 个 文 件 独 占 的 读 或 写 访 问 .

这 些 打 开 模 式 UNIX是 不 直 接 支 持 的 ,所 以 要 用 共 享 内 存 或 在 UNIX不 支 持 共 享 内 存 时 (一 般 都 支 持 )用 锁 定 文 件 来 模 拟 .

允 许 共 享 模 式 的 选 项 是 DENY_DOS, DENY_ALL, DENY_READ,DENY_WRITE, DENY_NONE 和 DENY_FCB.

缺 省 情 况 下 此 选 项 提 供 了 完 全 的 共 享 兼 容 和 许 可 .

你 不 应 把 此 选 项 关 闭 因 为 很 多 Windows应 用 会 因 此 停 止 运 行 。

缺 省 设 置 : share modes = yes

short preserve case (S)

此 布 尔 值 选 项 控 制 着 如 果 新 文 件 符 合 8.3文 件 名 格 式 (所 有 字 母 都 为 大 写 且 长 度 适 当 ),则 以 大 写 字 母 建 立 文 件 ， 否 则 就 转 换 为 default case .此 选 项 可 与 preserve case = yes选 项 联 用 ,以 允 许 长 文 件 名 保 留 大 小 写 ， 同 时 短 文 件 名 转 换 为 小 写 。

参 见 NAME MANGLING 段 .

缺 省 设 置 : short preserve case = yes

show add printer wizard (G)

With the introduction of MS-RPC based printing support for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will appear on Samba hosts in the share listing. Normally this folder will contain an icon for the MS Add Printer Wizard (APW). However, it is possible to disable this feature regardless of the level of privilege of the connected user.

Under normal circumstances, the Windows NT/2000 client will open a handle on the printer server with OpenPrinterEx() asking for Administrator privileges. If the user does not have administrative access on the print server (i.e is not root or a member of the printer admin group), the OpenPrinterEx() call fails and the client makes another open call with a request for a lower privilege level. This should succeed, however the APW icon will not be displayed.

Disabling the show add printer wizard parameter will always cause the OpenPrinterEx() on the server to fail. Thus the APW icon will never be displayed. Note :This does not prevent the same user from having administrative privilege on an individual printer.

参 见 addprinter command, deleteprinter command, printer admin

Default :show add printer wizard = yes

shutdown script (G)

This parameter only exists in the HEAD cvs branch This a full path name to a script called by smbd(8) that should start a shutdown procedure.

This command will be run as the user connected to the server.

%m %t %r %f parameters are expanded:

%m will be substituted with the shutdown message sent to the server.

%t will be substituted with the number of seconds to wait before effectively starting the shutdown procedure.

%r will be substituted with the switch -r. It means reboot after shutdown for NT.

%f will be substituted with the switch -f. It means force the shutdown even if applications do not respond for NT.

缺 省 设 置 : None.

示 例 : shutdown script = /usr/local/samba/sbin/shutdown %m %t %r %f

Shutdown script example:

#!/bin/bash
$time=0
let "time/60"
let "time++"

/sbin/shutdown $3 $4 +$time $1 &

Shutdown does not return so we need to launch it in background.

参 见 abort shutdown script.

smb passwd file (G)

此 选 项 设 置 加 密 口 令 文 件 smbpasswd的 路 径 .缺 省 路 径 在 编 译 samba时 指 定 .

缺 省 设 置 : smb passwd file = ${prefix}/private/smbpasswd

示 例 : smb passwd file = /etc/samba/smbpasswd

smb ports (G)

Specifies which ports the server should listen on for SMB traffic.

缺 省 设 置 : smb ports = 445 139

socket address (G)

此 选 项 允 许 你 控 制 samba监 听 连 接 所 用 的 地 址 .它 用 于 在 一 个 服 务 器 上 支 持 多 个 配 置 不 同 的 虚 拟 接 口 .缺 省 情 况 下 samba会 在 任 何 地 址 上 都 接 受 连 接 请 求 .

By default Samba will accept connections on any address.

示 例 : socket address = 192.168.2.20

socket options (G)

此 选 项 设 置 用 于 与 客 户 端 交 谈 的 套 接 字 选 项 .

套 接 字 选 项 是 使 用 在 允 许 调 整 连 接 的 操 作 系 统 的 网 络 层 的 控 制 命 令 .

此 选 项 通 常 用 于 在 局 域 网 上 优 化 调 整 samba服 务 器 的 性 能 .因 为 samba无 法 知 道 与 你 的 网 络 所 对 应 的 优 化 选 项 ,所 以 你 必 须 自 己 进 行 试 验 并 作 出 选 择 .我 们 强 烈 推 荐 你 先 阅 读 与 你 的 操 作 系 统 有 关 的 相 应 文 件 (也 许 man setsockopt会 有 帮 助 ).

你 可 能 会 发 现 在 有 些 系 统 上 samba会 在 你 使 用 一 个 选 项 时 发 出 "Unknown socket option"的 信 息 .这 就 说 明 你 没 有 正 确 拼 写 或 者 需 要 为 操 作 系 统 添 加 一 个 包 含 文 件 到 includes.h中 .如 有 后 面 指 出 的 问 题 请 写 信 到 samba-bugs [AT] samba.org.

只 要 操 作 系 统 允 许 ,你 可 以 以 任 何 方 法 组 合 任 何 所 支 持 的 套 接 字 选 项 .

当 前 可 用 于 此 选 项 的 可 设 置 套 接 字 选 项 列 表 有 ：

SO_KEEPALIVE

SO_REUSEADDR

SO_BROADCAST

TCP_NODELAY

IPTOS_LOWDELAY

IPTOS_THROUGHPUT

SO_SNDBUF *

SO_RCVBUF *

SO_SNDLOWAT *

SO_RCVLOWAT *

标 有 ’*’的 要 使 用 一 个 整 数 参 数 .其 它 的 有 时 使 用 1或 0代 表 允 许 或 禁 止 该 选 项 ,如 未 指 定 1或 0则 缺 省 值 都 为 允 许 .

要 指 定 一 个 变 量 ， 用 "SOME_OPTION=VALUE"格 式 。 比 如 可 以 是 SO_SNDBUF=8192.注 意 ,在 "="前 后 不 能 有 任 何 空 格 .

如 在 局 域 网 上 ,则 使 用 下 面 这 个 是 比 较 明 智 的 ：

socket options = IPTOS_LOWDELAY

如 有 一 个 局 域 网 则 可 以 试 一 下 ：

socket options = IPTOS_LOWDELAY TCP_NODELAY

如 有 一 个 广 域 网 ,则 试 一 下 IPTOS_THROUGHPU.

注 意 有 些 选 项 可 导 致 samba服 务 器 完 全 失 效 .小 心 使 用 它 们 ！

缺 省 设 置 : socket options = TCP_NODELAY

示 例 : socket options = IPTOS_LOWDELAY

source environment (G)

This parameter causes Samba to set environment variables as per the content of the file named.

If the value of this parameter starts with a "|" character then Samba will treat that value as a pipe command to open and will set the environment variables from the output of the pipe.

The contents of the file or the output of the pipe should be formatted as the output of the standard Unix env(1) command. This is of the form:

Example environment entry:

SAMBA_NETBIOS_NAME = myhostname

缺 省 设 置 : No default value

Examples: source environment = |/etc/smb.conf.sh

示 例 : source environment = /usr/local/smb_env_vars

stat cache (G)

此 选 项 检 测 smbd(8)是 否 使 用 缓 存 以 提 升 映 射 不 分 大 小 写 名 称 的 速 度 .你 无 须 更 改 此 选 项 .

缺 省 设 置 : stat cache = yes

strict allocate (S)

This is a boolean that controls the handling of disk space allocation in the server. When this is set to yes the server will change from UNIX behaviour of not committing real disk storage blocks when a file is extended to the Windows behaviour of actually forcing the disk system to allocate real storage blocks when a file is created or extended to be a given size. In UNIX terminology this means that Samba will stop creating sparse files. This can be slow on some systems.

When strict allocate is no the server does sparse disk block allocation when a file is extended.

Setting this to yes can help Samba return out of quota messages on systems that are restricting the disk quota of users.

缺 省 设 置 : strict allocate = no

strict locking (S)

此 布 尔 量 选 项 控 制 服 务 器 对 文 件 锁 的 处 理 .当 设 为 yes,则 服 务 器 对 文 件 锁 检 查 每 次 读 写 访 问 ,并 拒 绝 锁 存 在 时 的 访 问 .在 有 些 系 统 上 这 可 能 会 很 慢 .

当 禁 用 strict locking时 ,服 务 器 只 在 客 户 明 确 要 求 时 才 为 他 们 检 查 文 件 锁 .

循 规 蹈 矩 的 客 户 总 是 在 重 要 的 时 候 要 求 检 查 文 件 锁 ,所 以 在 多 数 情 况 下 strict locking = no是 可 取 的 .

缺 省 设 置 : strict locking = no

strict sync (S)

很 多 Windows应 用 (包 括 Windows 98浏 览 器 )都 会 干 扰 对 刷 新 缓 冲 区 内 容 到 磁 盘 的 操 作 .在 UNIX下 ,一 次 同 步 调 用 强 制 进 程 挂 起 ,直 到 内 核 确 保 把 所 有 磁 盘 缓 存 区 中 的 未 完 成 数 据 安 全 地 存 到 固 定 存 储 设 备 中 为 止 .此 操 作 很 慢 ,而 且 只 能 很 少 用 到 .把 此 选 项 设 为 no (缺 省 值 )说 明 smbd(8) 忽 略 Windows应 用 请 求 的 一 次 同 步 调 用 .这 样 只 有 在 Samba运 行 的 操 作 系 统 崩 溃 时 才 可 能 丢 失 数 据 ,因 此 缺 省 设 置 危 险 性 很 小 .另 外 ,它 修 正 人 们 报 告 的 很 多 关 于 Windows98浏 览 器 拷 贝 文 件 的 性 能 问 题 .

参 见 sync always 选 项 。

缺 省 设 置 : strict sync = no

sync always (S)

此 布 尔 量 选 项 控 制 是 否 在 写 操 作 结 束 前 把 所 写 的 内 容 写 到 固 定 存 储 设 备 上 .如 果 为 no则 服 务 器 将 在 每 次 写 调 用 中 让 客 户 请 求 来 操 纵 它 (客 户 可 以 设 置 一 个 位 码 来 指 出 要 同 步 一 次 特 殊 的 写 操 作 ).如 果 为 yes则 在 每 次 写 操 作 后 调 用 一 次 fsync() 以 确 保 将 数 据 写 到 磁 盘 上 .注 意 必 须 把 strict sync选 项 设 为 yes以 使 本 选 项 产 生 效 果 .

参 见 strict sync 选 项 。

缺 省 设 置 : sync always = no

syslog (G)

此 选 项 决 定 samba调 试 信 息 号 如 何 映 射 为 系 统 syslog的 记 录 等 级 .调 试 级 0映 射 为 syslog的 LOG_ERR,调 试 级 1映 射 为 LOG_WARNING,调 试 级 2映 射 为 LOG_NOTICE,调 试 级 3映 射 为 LOG_INFO.所 有 更 高 的 级 别 号 映 射 为 LOG_DEBUG.

此 选 项 设 置 了 对 syslog发 送 信 息 的 阈 值 .只 有 小 于 此 值 的 调 试 级 信 息 号 才 发 给 syslog.

缺 省 设 置 : syslog = 1

syslog only (G)

此 选 项 使 samba只 把 调 试 级 别 号 记 录 到 系 统 syslog,而 不 是 调 试 记 录 文 件 .

缺 省 设 置 : syslog only = no

template homedir (G)

When filling out the user information for a Windows NT user, the winbindd(8) daemon uses this parameter to fill in the home directory for that user. If the string %D is present it is substituted with the user’s Windows NT domain name. If the string %U is present it is substituted with the user’s Windows NT user name.

缺 省 设 置 : template homedir = /home/%D/%U

template primary group (G)

This option defines the default primary group for each user created by winbindd(8)’s local account management functions (similar to the ’add user script’).

缺 省 设 置 : template primary group = nobody

template shell (G)

When filling out the user information for a Windows NT user, the winbindd(8) daemon uses this parameter to fill in the login shell for that user.

缺 省 设 置 : template shell = /bin/false

time offset (G)

此 选 项 是 个 加 入 到 转 换 标 准 GMT为 当 地 时 间 操 作 的 分 钟 数 .如 果 你 向 很 多 有 不 正 确 保 存 时 间 操 作 的 主 机 提 供 服 务 时 这 就 很 有 用 了 .

缺 省 设 置 : time offset = 0

示 例 : time offset = 60

time server (G)

此 选 项 检 测 nmbd(8) 是 否 以 时 间 服 务 器 身 份 向 Windows客 户 通 告 自 身 .

缺 省 设 置 : time server = no

timestamp logs (G)

与 debug timestamp 同 义 .

unicode (G)

Specifies whether Samba should try to use unicode on the wire by default. Note: This does NOT mean that samba will assume that the unix machine uses unicode!

缺 省 设 置 : unicode = yes

unix charset (G)

Specifies the charset the unix machine Samba runs on uses. Samba needs to know this in order to be able to convert text to the charsets other SMB clients use.

缺 省 设 置 : unix charset = UTF8

示 例 : unix charset = ASCII

unix extensions (G)

This boolean parameter controls whether Samba implments the CIFS UNIX extensions, as defined by HP. These extensions enable Samba to better serve UNIX CIFS clients by supporting features such as symbolic links, hard links, etc... These extensions require a similarly enabled client, and are of no current use to Windows clients.

缺 省 设 置 : unix extensions = yes

unix password sync (G)

此 布 尔 量 选 项 控 制 samba是 否 在 smbpasswd文 件 中 的 加 密 SMB口 令 被 更 改 时 尝 试 用 SMB口 令 来 同 步 UNIX口 令 .如 设 为 yes则 以 root身 份 调 用 passwd program选 项 中 指 定 的 程 序 - 以 允 许 设 置 新 的 UNIX口 令 而 无 需 访 问 原 UNIX口 令 (因 为 更 改 SMB口 令 时 代 码 不 访 问 明 文 的 原 口 令 而 只 涉 及 新 口 令 ).

参 见 passwd program, passwd chat.

缺 省 设 置 : unix password sync = no

update encrypted (G)

此 布 尔 量 选 项 使 以 明 文 口 令 登 录 的 用 户 在 登 录 时 自 动 更 新 smbpasswd文 件 中 的 加 密 (散 列 计 算 过 的 )口 令 .此 选 项 允 许 一 个 站 点 从 明 文 口 令 验 证 方 式 (以 明 文 口 令 验 证 用 户 账 号 并 再 次 检 查 UNIX账 号 数 据 库 )移 植 到 加 密 口 令 验 证 方 式 (SMB的 询 问 /响 应 验 证 机 制 )而 无 需 强 制 所 有 用 户 在 移 植 时 通 过 smbpasswd重 新 输 入 他 们 的 口 令 .这 对 改 变 加 密 口 令 移 交 要 较 长 周 期 这 种 状 况 来 说 很 方 便 .一 旦 所 有 用 户 都 在 smbpasswd文 件 中 拥 有 他 们 加 密 过 的 口 令 ,则 此 应 该 把 此 选 项 设 为 no.

为 了 让 此 选 项 正 确 工 作 ,当 它 设 为 yes时 必 须 把 encrypt passwords选 项 设 为 no .

注 意 即 使 设 置 了 此 选 项 ,smbd还 是 必 须 验 证 用 户 账 号 ,直 到 输 入 合 法 的 口 令 后 才 能 正 确 连 接 并 更 新 他 们 的 散 列 计 算 (由 smbpasswd完 成 )后 的 口 令 字 .

缺 省 设 置 : update encrypted = no

use client driver (S)

This parameter applies only to Windows NT/2000 clients. It has no effect on Windows 95/98/ME clients. When serving a printer to Windows NT/2000 clients without first installing a valid printer driver on the Samba host, the client will be required to install a local printer driver. From this point on, the client will treat the print as a local printer and not a network printer connection. This is much the same behavior that will occur when disable spoolss = yes.

The differentiating factor is that under normal circumstances, the NT/2000 client will attempt to open the network printer using MS-RPC. The problem is that because the client considers the printer to be local, it will attempt to issue the OpenPrinterEx() call requesting access rights associated with the logged on user. If the user possesses local administator rights but not root privilegde on the Samba host (often the case), the OpenPrinterEx() call will fail. The result is that the client will now display an "Access Denied; Unable to connect" message in the printer queue window (even though jobs may successfully be printed).

If this parameter is enabled for a printer, then any attempt to open the printer with the PRINTER_ACCESS_ADMINISTER right is mapped to PRINTER_ACCESS_USE instead. Thus allowing the OpenPrinterEx() call to succeed. This parameter MUST not be able enabled on a print share which has valid print driver installed on the Samba server.

参 见 disable spoolss

缺 省 设 置 : use client driver = no

use mmap (G)

This global parameter determines if the tdb internals of Samba can depend on mmap working correctly on the running system. Samba requires a coherent mmap/read-write system memory cache. Currently only HPUX does not have such a coherent cache, and so this parameter is set to no by default on HPUX. On all other systems this parameter should be left alone. This parameter is provided to help the Samba developers track down problems with the tdb internal code.

缺 省 设 置 : use mmap = yes

user (S)

与 username 同 义

username (S)

在 逗 号 分 隔 的 列 表 中 指 定 多 个 用 户 以 用 于 轮 流 (从 左 到 右 )测 试 所 提 供 的 口 令 .

只 有 当 主 机 无 法 提 供 它 自 己 的 用 户 名 时 才 需 要 username选 项 。 当 用 COREPLUS 协 议 或 你 的 用 户 拥 有 与 UNIX用 户 名 不 同 的 WfWg用 户 名 时 就 会 有 这 样 的 情 况 .在 这 两 种 情 况 下 ,用 \\server\share%user语 句 代 替 会 更 好 的 .

在 大 多 数 情 况 下 username选 项 并 不 是 最 好 的 解 决 方 案 ,因 为 它 意 味 着 Samba会 尝 试 对 username选 项 行 中 的 每 个 用 户 名 轮 流 作 测 试 .这 样 做 是 很 慢 的 ,而 且 万 一 很 多 用 户 重 复 口 令 的 话 这 就 是 个 坏 主 意 了 .错 误 使 用 此 选 项 可 能 会 带 来 超 时 或 安 全 缺 陷 .

samba依 靠 底 层 的 UNIX安 全 .此 选 项 不 限 制 登 录 者 ,它 只 对 Samba服 务 器 提 供 响 应 所 提 供 口 令 的 用 户 名 的 线 索 .任 何 喜 欢 的 人 都 可 以 登 录 ,而 且 如 果 他 们 只 是 启 动 一 次 telnet对 话 的 话 不 会 造 成 破 坏 .进 程 以 登 录 的 用 户 身 份 运 行 ,所 以 他 们 无 法 做 任 何 他 们 不 能 做 的 事 儿 .

要 对 一 组 特 殊 的 用 户 限 制 一 个 服 务 的 话 可 以 用 valid users 选 项 .

如 果 任 何 用 户 名 以 ’@’字 符 开 始 则 此 用 户 名 将 首 先 在 NIS网 络 组 列 表 (如 果 Samba编 译 时 加 入 了 网 络 组 支 持 的 话 )中 进 行 查 找 ,然 后 在 UNIX用 户 组 数 据 库 中 查 找 并 展 开 成 属 于 以 此 名 为 组 的 所 有 用 户 的 列 表 .

如 果 任 何 用 户 名 以 ’+’字 符 开 始 则 此 用 户 名 只 在 UNIX用 户 组 数 据 库 中 进 行 查 找 并 展 开 成 属 于 以 此 名 为 组 的 所 有 用 户 的 列 表 .

如 果 任 何 用 户 名 以 ’&’字 符 开 始 则 此 用 户 名 只 在 NIS网 络 组 列 表 (如 果 Samba编 译 时 加 入 了 网 络 组 支 持 的 话 )中 进 行 查 找 并 展 开 成 属 于 以 此 名 为 组 的 所 有 用 户 的 列 表 .

注 意 通 过 用 户 组 数 据 库 进 行 查 找 要 花 很 长 时 间 ,在 此 期 间 有 些 客 户 可 能 会 超 时 .

查 看 NOTE ABOUT USERNAME/PASSWORD VALIDATION 段 来 获 得 这 个 选 项 如 何 决 定 访 问 服 务 方 面 的 信 息 。

缺 省 设 置 : 如 果 是 guest服 务 就 是 guest帐 号 ,否 则 是 空 字 符 串 .

示 例 :username = fred, mary, jack, jane, @users, @pcgroup

username level (G)

此 选 项 在 很 多 DOS客 户 发 送 全 大 写 的 用 户 名 时 ,帮 助 samba尝 试 和 “猜 测 ”实 际 UNIX用 户 名 .对 于 缺 省 情 况 ,Samba尝 试 所 有 小 写 形 式 ,然 后 是 首 字 母 大 写 形 式 ,如 果 该 用 户 名 在 UNIX主 机 上 没 有 找 到 则 失 败 .

如 果 把 此 选 项 设 为 非 0,则 情 况 就 改 变 了 .此 选 项 指 定 的 是 用 于 尝 试 同 时 检 测 UNIX用 户 名 的 大 写 字 母 的 组 合 数 .数 字 越 高 ,则 尝 试 的 组 合 数 越 多 ,但 用 户 名 的 发 现 也 越 慢 .当 在 你 的 UNIX主 机 上 有 奇 特 的 用 户 名 如 AstrangeUser 时 使 用 此 选 项 .

缺 省 设 置 : username level = 0

示 例 : username level = 5

username map (G)

此 选 项 允 许 你 指 定 一 个 包 含 对 客 户 机 到 服 务 器 上 的 用 户 名 映 射 的 文 件 .它 可 用 于 几 个 目 的 .最 常 见 的 是 把 用 DOS或 Windows主 机 的 用 户 的 名 称 映 射 到 UNIX主 机 上 的 用 户 .其 它 还 有 把 多 个 用 户 映 射 到 单 个 用 户 名 上 以 使 他 们 可 以 更 简 单 地 共 享 文 件 .

映 射 文 件 被 逐 行 解 析 .每 个 行 都 应 该 在 ’=’号 左 边 包 含 一 个 UNIX用 户 名 ,而 在 右 边 跟 上 一 列 用 户 名 .右 边 的 用 户 名 列 表 可 以 包 含 @group形 式 的 名 称 ,它 表 示 匹 配 任 何 组 中 的 UNIX用 户 名 .特 殊 客 户 名 ’*’是 一 个 通 配 符 用 于 匹 配 任 何 名 称 .映 射 文 件 的 每 个 行 可 以 达 到 1023个 字 符 的 长 度 .

对 文 件 的 处 理 是 在 每 个 行 上 取 得 提 供 的 用 户 名 并 把 它 与 ’=’号 右 边 的 每 个 用 户 名 进 行 比 较 .如 果 提 供 的 名 称 匹 配 右 边 的 任 何 名 称 则 用 左 边 的 名 称 替 换 右 边 的 .然 后 继 续 处 理 下 一 行 .

忽 略 以 ’#’ 或 ’;’号 开 始 的 行 .

当 在 行 中 发 现 了 匹 配 ,则 在 以 ’!’开 始 的 行 后 中 止 处 理 ,否 则 继 续 处 理 每 一 行 的 映 射 .当 你 在 文 件 中 用 了 通 配 映 射 的 话 ’!’就 很 有 用 了 .

例 如 把 名 称 admin 或 administrator映 射 为 UNIX名 root,你 可 以 这 样 ：

root = admin administrator

或 把 UNIX组 system中 的 任 何 人 映 射 为 UNIX名 sys就 可 以 这 样 ：

sys = @system

可 以 在 一 个 用 户 名 映 射 文 件 中 包 含 很 多 映 射 关 系 .

如 果 你 的 系 统 支 持 NIS NETGROUP选 项 ,则 在 使 用 /etc/group 匹 配 组 之 前 先 检 查 网 络 组 数 据 库 .

你 可 以 通 过 在 名 称 上 使 用 双 引 号 来 映 射 含 有 空 格 的 Windows用 户 名 .例 如 ：

tridge = "Andrew Tridgell"

将 把 windows用 户 名 "Andrew Tridgell"映 射 为 unix用 户 名 "tridge".

以 下 示 例 将 把 mary和 fred映 射 为 unix用 户 sys,然 后 把 其 余 的 映 射 为 guest.注 意 使 用 ’!’符 号 可 以 告 诉 Samba如 果 在 该 行 获 得 一 个 匹 配 的 话 就 停 止 处 理 .

!sys = mary fred
guest = *

注 意 重 映 射 作 用 于 所 有 出 现 用 户 名 的 地 方 .因 此 如 果 你 连 接 到 \\server\fred而 fred已 被 重 映 射 为 mary,则 你 实 际 会 连 接 到 \\server\mary"并 需 要 提 供 mary的 口 令 而 不 是 fred的 .这 种 情 况 只 有 一 个 例 外 ,那 就 是 用 户 名 是 被 传 到 password server(如 果 你 有 一 个 的 话 )验 证 的 .口 令 服 务 器 会 接 收 客 户 提 供 的 未 经 修 改 的 用 户 名 .

同 时 要 注 意 反 向 映 射 是 不 会 出 现 的 .这 主 要 影 响 的 是 打 印 任 务 .已 经 被 映 射 的 用 户 会 在 删 除 打 印 任 务 时 遇 到 麻 烦 ,因 为 WfWg上 的 打 印 管 理 器 会 认 为 他 们 不 是 打 印 任 务 的 属 主 .

缺 省 设 置 : no username map

示 例 : username map = /usr/local/samba/lib/users.map

users (S)

与 username 同 义 .

use sendfile (S)

If this parameter is yes, and Samba was built with the --with-sendfile-support option, and the underlying operating system supports sendfile system call, then some SMB read calls (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that are exclusively oplocked. This may make more efficient use of the system CPU’s and cause Samba to be faster. This is off by default as it’s effects are unknown as yet.

缺 省 设 置 : use sendfile = no

use spnego (G)

This variable controls controls whether samba will try to use Simple and Protected NEGOciation (as specified by rfc2478) with WindowsXP and Windows2000 clients to agree upon an authentication mechanism. Unless further issues are discovered with our SPNEGO implementation, there is no reason this should ever be disabled.

缺 省 设 置 : use spnego = yes

utmp (G)

This boolean parameter is only available if Samba has been configured and compiled with the option --with-utmp. If set to yes then Samba will attempt to add utmp or utmpx records (depending on the UNIX system) whenever a connection is made to a Samba server. Sites may use this to record the user connecting to a Samba share.

Due to the requirements of the utmp record, we are required to create a unique identifier for the incoming user. Enabling this option creates an n^2 algorithm to find this number. This may impede performance on large installations.

参 见 utmp directory 选 项 。

缺 省 设 置 : utmp = no

utmp directory (G)

This parameter is only available if Samba has been configured and compiled with the option --with-utmp. It specifies a directory pathname that is used to store the utmp or utmpx files (depending on the UNIX system) that record user connections to a Samba server. 参 见 utmp 选 项 。 By default this is not set, meaning the system will use whatever utmp file the native system is set to use (usually /var/run/utmp on Linux).

缺 省 设 置 : no utmp directory

示 例 : utmp directory = /var/run/utmp

-valid (S)

This parameter indicates whether a share is valid and thus can be used. When this parameter is set to false, the share will be in no way visible nor accessible.

This option should not be used by regular users but might be of help to developers. Samba uses this option internally to mark shares as deleted.

缺 省 设 置 : True

valid users (S)

这 是 一 份 允 许 登 录 服 务 项 的 用 户 列 表 .以 ’@’,’+’和 ’&’开 始 的 名 称 用 invalid users 选 项 中 的 规 则 进 行 解 析 .

如 果 此 项 为 空 (缺 省 )则 任 何 用 户 都 可 以 登 录 .如 果 一 个 用 户 名 同 时 存 在 于 此 列 表 及 invalid users列 表 ,则 拒 绝 此 用 户 访 问 .

%S 替 换 为 当 前 服 务 名 . 这 在 [homes]段 里 非 常 有 用 .

参 见 invalid users

缺 省 设 置 : 空 (任 何 人 都 不 会 被 拒 绝 )

示 例 : valid users = greg, @pcusers

veto files (S)

这 是 一 份 既 不 可 见 又 不 可 访 问 的 文 件 及 目 录 的 列 表 .在 列 表 中 的 每 一 项 必 须 用 ’/’进 行 分 隔 ,项 目 中 允 许 有 空 格 .可 以 用 DOS通 配 符 ’*’和 ’?’来 指 定 多 个 文 件 或 目 录 .

每 项 必 须 是 一 个 UNIX路 径 ,而 非 一 个 DOS路 径 ,同 时 必 须 不 含 UNIX目 录 分 隔 符 ’/’.

注 意 case sensitive选 项 适 用 于 对 文 件 的 禁 止 目 的 .

需 要 明 白 这 个 选 项 的 很 重 要 的 一 个 特 点 : 在 Samba删 除 一 个 目 录 时 的 行 为 。 如 果 一 个 目 录 除 了 veto files之 外 不 包 含 任 何 内 容 ， 删 除 操 作 将 失 败 ， 除 非 设 置 了 delete veto files 是 yes.

设 置 此 选 项 会 影 响 Samba的 性 能 ,因 为 它 将 强 制 在 扫 描 所 有 文 件 和 目 录 时 检 查 是 否 匹 配 .

参 见 hide files 和 case sensitive.

缺 省 设 置 : 没 有 隐 藏 任 何 文 件 .

示 例 :

; 隐 藏 任 何 文 件 名 带 有 ’Security’的 文 件 ，
; 任 何 扩 展 名 是 .tmp的 文 件 ,任 何 文 件 名 带 有 ’root’的 文 件
veto files = /*Security*/*.tmp/*root*/

; 隐 藏 NetAtalk服 务 器 创 建 的 Apple专 用 的 文 件
veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/

veto oplock files (S)

此 选 项 只 在 对 一 个 共 享 打 开 了 oplocks选 项 时 才 有 效 .它 允 许 Samba管 理 员 在 所 选 文 件 上 选 择 性 地 关 闭 允 许 oplocks,这 些 文 件 可 以 用 通 配 符 列 表 来 匹 配 ,类 拟 于 在 veto files 选 项 中 所 用 的 通 配 符 列 表 .

缺 省 设 置 : 没 有 隐 藏 oplocks许 可

你 可 能 想 在 已 知 客 户 会 猛 烈 争 夺 的 文 件 上 使 用 此 项 .在 NetBench SMB基 准 程 序 下 面 就 是 个 好 例 子 ,它 导 致 客 户 猛 烈 地 对 以 .SEM后 缀 的 文 件 进 行 连 接 .为 使 Samba不 在 这 些 文 件 上 允 许 oplocks,你 可 以 在 [global]段 或 特 定 的 NetBench共 享 中 使 用 此 行 ：

示 例 : veto oplock files = /*.SEM/

vfs object (S)

与 vfs objects 同 义 .

vfs objects (S)

This parameter specifies the backend names which are used for Samba VFS I/O operations. By default, normal disk I/O operations are used but these can be overloaded with one or more VFS objects.

缺 省 设 置 : no value

示 例 : vfs objects = extd_audit recycle

volume (S)

此 选 项 允 许 你 忽 略 共 享 项 提 供 的 卷 标 .这 对 于 那 些 坚 持 要 使 用 一 个 特 殊 卷 标 的 安 装 程 序 光 盘 来 说 很 有 用 .缺 省 就 是 共 享 项 的 卷 标 .

缺 省 设 置 : 共 享 的 名 称

wide links (S)

此 选 项 控 制 服 务 器 是 否 跟 踪 UNIX文 件 系 统 中 的 符 号 链 接 .指 向 服 务 器 导 出 的 目 录 树 的 链 接 总 是 被 允 许 的 ； 此 选 项 只 是 控 制 对 导 出 目 录 树 以 外 的 区 域 的 访 问 情 况 .

注 意 设 置 此 选 项 可 对 服 务 器 性 能 产 生 负 面 影 响 ,因 为 samba必 须 做 一 些 额 外 的 系 统 调 用 以 检 查 那 些 链 接 .

缺 省 设 置 : wide links = yes

winbind cache time (G)

This parameter specifies the number of seconds the winbindd(8) daemon will cache user and group information before querying a Windows NT server again.

缺 省 设 置 : winbind cache type = 300

winbind enable local accounts (G)

This parameter controls whether or not winbindd will act as a stand in replacement for the various account management hooks in smb.conf (e.g. ’add user script’). If enabled, winbindd will support the creation of local users and groups as another source of UNIX account information available via getpwnam() or getgrgid(), etc...

缺 省 设 置 : winbind enable local accounts = yes

winbind enum groups (G)

On large installations using winbindd(8) it may be necessary to suppress the enumeration of groups through the setgrent(), getgrent() and endgrent() group of system calls. If the winbind enum groups parameter is no, calls to the getgrent() system call will not return any data.

Warning: Turning off group enumeration may cause some programs to behave oddly.

缺 省 设 置 : winbind enum groups = yes

winbind enum users (G)

On large installations using winbindd(8) it may be necessary to suppress the enumeration of users through the setpwent(), getpwent() and endpwent() group of system calls. If the winbind enum users parameter is no, calls to the getpwent system call will not return any data.

Warning: Turning off user enumeration may cause some programs to behave oddly. For example, the finger program relies on having access to the full user list when searching for matching usernames.

缺 省 设 置 : winbind enum users = yes

winbind gid (G)

This parameter is now an alias for idmap gid

The winbind gid parameter specifies the range of group ids that are allocated by the winbindd(8) daemon. This range of group ids should have no existing local or NIS groups within it as strange conflicts can occur otherwise.

缺 省 设 置 : winbind gid = <空 字 符 串 >

示 例 : winbind gid = 10000-20000

winbind separator (G)

This parameter allows an admin to define the character used when listing a username of the form of DOMAIN \user. This parameter is only applicable when using the pam_winbind.so and nss_winbind.so modules for UNIX services.

Please note that setting this parameter to + causes problems with group membership at least on glibc systems, as the character + is used as a special character for NIS in /etc/group.

缺 省 设 置 : winbind separator = ’´

示 例 : winbind separator = +

winbind trusted domains only (G)

This parameter is designed to allow Samba servers that are members of a Samba controlled domain to use UNIX accounts distributed vi NIS, rsync, or LDAP as the uid’s for winbindd users in the hosts primary domain. Therefore, the user ’SAMBA\user1’ would be mapped to the account ’user1’ in /etc/passwd instead of allocating a new uid for him or her.

缺 省 设 置 : winbind trusted domains only = <no>

winbind uid (G)

This parameter is now an alias for idmap uid

The winbind gid parameter specifies the range of user ids that are allocated by the winbindd(8) daemon. This range of ids should have no existing local or NIS users within it as strange conflicts can occur otherwise.

缺 省 设 置 : winbind uid = <空 字 符 串 >

示 例 : winbind uid = 10000-20000

winbind use default domain (G)

This parameter specifies whether the winbindd(8) daemon should operate on users without domain component in their username. Users without a domain component are treated as is part of the winbindd server’s own domain. While this does not benifit Windows users, it makes SSH, FTP and e-mail function in a way much closer to the way they would in a native unix system.

缺 省 设 置 : winbind use default domain = <no>

示 例 : winbind use default domain = yes

wins hook (G)

当 把 Samba作 为 一 台 WINS服 务 器 运 行 时 ,此 选 项 允 许 你 调 用 一 个 外 部 程 序 更 改 WINS数 据 库 .此 项 主 要 用 于 动 态 更 新 外 部 名 字 解 析 数 据 库 ,如 动 态 DNS.

此 选 项 以 如 下 形 式 指 定 要 调 用 的 一 个 脚 本 名 或 可 执 行 程 序 ：

wins_hook operation name nametype ttl IP_list

第 一 部 分 参 数 是 opration(操 作 符 ),它 有 三 种 ： "add"、 "delete"和 "refresh".在 很 多 情 况 下 该 操 作 符 可 以 忽 略 ,因 为 其 它 选 项 可 提 供 足 够 的 信 息 .注 意 当 有 名 称 以 前 没 有 加 入 过 ,则 有 时 会 用 到 "refresh",在 这 种 情 况 下 ,它 应 该 和 "add"有 同 样 含 义 .

第 二 部 分 参 数 是 netbios名 .如 果 该 名 称 不 是 合 法 名 的 话 ,该 功 能 就 不 运 行 .合 法 的 名 称 应 只 包 含 字 母 ,数 字 ,减 号 ,下 划 线 和 句 点 .

第 三 部 分 参 数 是 用 2位 十 六 进 制 数 字 表 示 的 netbios名 称 类 型 .

第 四 部 分 参 数 是 以 秒 计 算 的 名 称 有 效 时 间 TTL (time to live).

第 五 部 分 是 当 前 该 名 称 所 注 册 的 IP地 址 表 .如 果 表 为 空 则 该 名 称 被 删 除 .

一 个 调 用 BIND动 态 DNS更 新 程 序 nsupdate的 脚 本 示 例 在 samba源 代 码 的 示 例 目 录 可 以 找 到 .

wins partners (G)

A space separated list of partners’ IP addresses for WINS replication. WINS partners are always defined as push/pull partners as defining only one way WINS replication is unreliable. WINS replication is currently experimental and unreliable between samba servers.

缺 省 设 置 : wins partners =

示 例 : wins partners = 192.168.0.1 172.16.1.2

wins proxy (G)

此 布 尔 量 选 项 控 制 nmbd(8) 是 否 代 替 其 它 主 机 响 应 广 播 名 字 查 询 .对 一 些 旧 版 本 客 户 就 可 能 需 要 把 它 设 为 yes .

缺 省 设 置 : wins proxy = no

wins server (G)

此 选 项 指 定 nmbd要 注 册 的 WINS服 务 器 的 IP地 址 (或 DNS域 名 ： IP地 址 优 先 (for preference)).如 果 在 你 的 网 络 上 有 一 台 WINS服 务 器 ,就 应 该 把 此 项 设 为 该 服 务 器 的 IP地 址 .

如 果 你 有 多 个 子 网 的 话 ,应 该 指 定 向 你 的 WINS服 务 器

If you want to work in multiple namespaces, you can give every wins server a ’tag’. For each tag, only one (working) server will be queried for a name. The tag should be seperated from the ip address by a colon.

注 意 ,如 有 多 子 网 并 希 望 跨 子 网 浏 览 工 作 正 常 的 话 ,应 该 设 置 Samba指 向 一 台 WINS服 务 器 .

缺 省 设 置 : 未 启 用

示 例 : wins server = mary:192.9.200.1 fred:192.168.3.199 mary:192.168.2.61

For this example when querying a certain name, 192.19.200.1 will be asked first and if that doesn’t respond 192.168.2.61 . If either of those doesn’t know the name 192.168.3.199 will be queried.

示 例 : wins server = 192.9.200.1 192.168.2.61

wins support (G)

此 布 尔 量 选 项 控 制 nmbd(8)进 程 是 否 作 为 WINS服 务 器 .你 不 应 该 把 它 设 为 yes,除 非 有 多 子 网 或 希 望 特 定 的 nmbd作 为 你 的 WINS服 务 器 .注 意 在 网 络 上 有 多 台 WINS服 务 器 时 不 应 把 它 设 为 yes.

缺 省 设 置 : wins support = no

workgroup (G)

此 选 项 规 定 Samba所 在 的 工 作 组 以 便 让 客 户 查 询 .注 意 它 也 规 定 在 使 用 security = domain时 所 用 的 域 名 .

缺 省 设 置 : 编 译 时 设 置 为 WORKGROUP

示 例 : workgroup = MYGROUP

writable (S)

与 writeable 相 同 ， 是 为 拼 写 错 误 者 准 备 的 :-)

writeable (S)

注 意 它 与 read only 反 义 .

write cache size (S)

If this integer parameter is set to non-zero value, Samba will create an in-memory cache for each oplocked file (it does not do this for non-oplocked files). All writes that the client does not request to be flushed directly to disk will be stored in this cache if possible. The cache is flushed onto disk when a write comes in whose offset would not fit into the cache or when the file is closed by the client. Reads for the file are also served from this cache if the data is stored within it.

This cache allows Samba to batch client writes into a more efficient write size for RAID disks (i.e. writes may be tuned to be the RAID stripe size) and can improve performance on systems where the disk subsystem is a bottleneck but there is free memory for userspace programs.

The integer parameter specifies the size of this cache (per oplocked file) in bytes.

缺 省 设 置 : write cache size = 0

示 例 : write cache size = 262144

for a 256k cache size per file.

write list (S)

此 选 项 设 置 对 服 务 项 有 读 写 权 的 用 户 列 表 .如 果 正 在 连 接 的 用 户 属 于 此 列 表 ,那 他 们 就 可 以 有 写 入 权 ,而 不 管 read only为 何 值 .此 列 表 可 以 用 @group形 式 描 述 组 名 .

注 意 如 果 一 个 用 户 同 时 属 于 读 列 表 和 写 列 表 则 拥 有 写 入 权 .

参 见 read list 选 项 。

缺 省 设 置 : write list = <空 字 符 串 >

示 例 : write list = admin, root, @staff

write ok (S)

注 意 它 与 read only 反 义 .

write raw (G)

此 选 项 规 定 服 务 器 是 否 在 从 客 户 端 传 输 数 据 时 支 持 原 始 方 式 写 SMB消 息 块 .你 不 应 该 更 改 它 .

缺 省 设 置 : write raw = yes

wtmp directory (G)

This parameter is only available if Samba has been configured and compiled with the option --with-utmp. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on the UNIX system) that record user connections to a Samba server. The difference with the utmp directory is the fact that user info is kept after a user has logged out.

参 见 utmp 选 项 。 By default this is not set, meaning the system will use whatever utmp file the native system is set to use (usually /var/run/wtmp on Linux).

缺 省 设 置 : no wtmp directory

示 例 : wtmp directory = /var/log/wtmp

警 告 WARNINGS

虽 然 配 置 文 件 允 许 服 务 项 名 包 含 空 格 ,但 你 的 客 户 端 软 件 就 不 一 定 了 .因 为 在 比 较 中 总 是 忽 略 空 格 ,所 以 这 不 成 问 题 - 但 应 该 认 识 到 其 它 可 能 性 .

有 一 条 类 似 提 示 ,很 多 客 户 特 别 是 DOS客 户 ,会 限 制 服 务 项 名 为 8个 字 符 .虽 然 smbd(8)没 有 这 样 的 限 制 ,但 如 果 这 样 的 客 户 截 去 部 分 服 务 项 名 的 话 ,他 们 的 连 接 尝 试 会 失 败 .为 此 你 可 能 要 保 持 你 的 服 务 项 名 在 8个 字 符 以 内 .

对 于 管 理 员 来 说 [homes] 和 [printers]特 殊 段 的 使 用 很 容 易 ,但 对 缺 省 属 性 的 多 样 组 合 应 该 小 心 .当 设 计 这 些 段 时 要 特 别 仔 细 .特 别 是 要 确 保 假 脱 机 目 录 权 限 的 正 确 性 .

版 本 VERSION

此 手 册 页 是 针 对 samba套 件 版 本 3.0的 。

参 见 SEE ALSO

samba(7), smbpasswd(8), swat(8), smbd(8), nmbd(8), smbclient(1), nmblookup(1), testparm(1), testprns(1).

作 者 AUTHOR

samba软 件 和 相 关 工 具 最 初 由 Andrew Tridgell创 建 。 samba现 在 由 Samba Team 作 为 开 源 软 件 来 发 展 ， 类 似 linux内 核 的 开 发 方 式 。

最 初 的 samba手 册 页 是 Karl Auer写 的 。 手 册 页 源 码 已 经 转 换 为 YODL格 式 (另 一 种 很 好 的 开 源 软 件 ， 可 以 在 ftp://ftp.ice.rug.nl/pub/unix找; 到 )， 由 Jeremy Sllison 更 新 到 Samba2.0 版 本 。 Gerald Carter 在 Samba2.2中 将 它 转 化 为 DocBook 格 式 。 Alexander Bokovoy 在 Samba 3.0中 实 现 了 DocBook XML4.2 格 式 的 转 换 。

[中 文 版 维 护 人 ]

meaculpa <meaculpa [AT] 21cn.com>

[中 文 版 最 新 更 新 ]

2000/12/08

《 中 国 linux论 坛 man手 册 页 翻 译 计 划 》 :

http://cmpp.linuxforum.net

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh