Manpages

NAME

smbd - 向 客 户 提 供 SMB/CIFS服 务 的 服 务 器

总 览 SYNOPSIS

smbd [-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>][-p <port number>] [-O <socket option>] [-s <configuration file>]

描 述 DESCRIPTION

此 程 序 是 Samba(7) 套 件 的 一 部 分 。

smbd 是 向 Windows客 户 机 提 供 文 件 共 享 和 打 印 服 务 的 服 务 器 进 程 。 该 服 务 器 用 SMB(或 CIFS)协 议 向 客 户 提 供 文 件 存 放 空 间 和 打 印 服 务 。 它 与 LanManager协 议 兼 容 并 能 向 使 用 此 协 议 的 客 户 提 供 服 务 。 这 些 客 户 端 包 括 MSCLIENT 3.0 for DOS, Windows for Workgroups, Windows 95/98/ME, Windows NT, Windows 2000, OS/2, DAVE for Macintosh, 和 smbfs for Linux。 用 来 控 制 服 务 属 性 的 配 置 文 件 的 手 册 页 中 对 服 务 器 可 提 供 的 服 务 进 行 了 详 细 的 描 述 (参 见 smb.conf (5))。 此 手 册 不 描 述 提 供 的 服 务 但 集 中 讲 述 了 对 管 理 服 务 器 运 行 等 方 面 的 问 题 描 述 。 请 注 意 对 服 务 器 运 行 有 关 的 非 常 重 要 的 安 全 性 问 题 , 同 时 在 进 行 安 装 处 理 前 也 应 该 仔 细 阅 读 smb.conf (5)手 册 。 只 要 有 客 户 请 求 就 会 建 立 一 个 对 话 。 对 每 个 对 话 , 每 个 客 户 获 得 服 务 器 的 一 份 复 本 。 在 对 话 期 间 此 复 本 对 所 有 客 户 产 生 的 连 接 进 行 服 务 。 当 来 自 此 客 户 的 所 有 连 接 都 关 闭 时 , 此 客 户 的 服 务 器 复 本 也 退 出 。 服 务 器 所 包 含 的 配 置 文 件 和 其 它 任 何 文 件 都 会 在 每 次 更 改 后 自 动 重 新 装 入 。 你 可 以 通 过 对 服 务 器 发 送 一 个 SIGHUP信 息 来 强 制 一 次 重 新 装 入 。 重 新 装 入 配 置 文 件 对 已 建 立 的 任 何 对 服 务 的 连 接 均 无 效 。 要 么 用 户 必 须 断 开 服 务 , 要 么 将 smbd进 程 中 止 并 重 启 。

选 项 OPTIONS

-D 如 果 指 定 此 选 项 , 则 服 务 器 以 后 台 进 程 方 式 运 行 。 即 , 它 会 分 离 本 身 并 在 后 台 运 行 , 在 适 当 的 端 口 上 监 听 请 求 。 对 于 提 供 比 临 时 性 的 文 件 和 打 印 服 务 更 多 内 容 的 服 务 器 , 推 荐 将

smbd 以 后 台 进 程 方 式 运 行 。 如 果 在 shell命 令 行 运 行 smbd , 将 默 认 使 用 这 个 选 项 。

-F

If specified, this parameter causes the main smbd process to not daemonize, i.e. double-fork and disassociate with the terminal. Child processes are still created as normal to service each connection request, but the main process does not exit. This operation mode is suitable for running smbd under process supervisors such as supervise and svscan from Daniel J. Bernstein’s daemontools package, or the AIX process monitor.

-S

If specified, this parameter causes smbd to log to standard output rather than a file.

-i

If this parameter is specified it causes the server to run "interactively", not as a daemon, even if the server is executed on the command line of a shell. Setting this parameter negates the implicit deamon mode when run from the command line. smbd also logs to standard output, as if the -S parameter had been given.

-V

打 印 smbd的 版 本 号 。

-s <configuration file> 指 定 的 文 件 包 含 了 服 务 器 所 需 的 配 置 细 节 。 此 文 件 中 的 信 息 包 含 如 所 用 的 printcap文 件 这 样 的 服 务 器 详 细 信 息 , 同 时 也 对 服 务 器 所 提 供 的 服 务 进 行 了 描 述 。 请 参 见 smb.conf (5)文 件 。 缺 省 的 配 置 文 件 名 在 软 件 包 编 译 时 决 定 。
-d|--debug=debuglevel

debuglevel 是 一 个 从 0到 10的 整 数 。 如 果 没 有 指 定 此 参 数 则 默 认 的 值 是 0。 如 果 这 个 值 越 高 , 越 多 关 于 服 务 器 的 详 细 活 动 信 息 将 被 记 录 到 文 件 中 。 在 0调 试 级 时 , 只 记 录 紧 急 错 误 和 严 重 警 告 。 对 于 平 日 的 运 行 服 务 , 1调 试 级 是 个 合 理 的 等 级 , 它 只 产 生 小 量 的 关 于 执 行 操 作 的 信 息 。

1以 上 的 调 试 级 将 产 生 相 当 多 的 记 录 数 据 , 并 且 只 在 解 决 问 题 时 才 有 用 。 3以 上 的 调 试 级 只 被 设 计 为 让 开 发 者 使 用 并 会 产 生 极 大 数 量 的 记 录 数 据 , 而 且 其 中 很 多 部 分 非 常 难 以 理 解 。 注 意 在 此 使 用 这 个 参 数 将 越 过 在 smb.conf (5)文 件 中 的 log level参 数 。

-l|--logfile=logbasename 用 来 记 录 /调 试 的 文 件 。 会 自 动 为 它 添 加 ".client" 扩 展 名 。 客 户 端 不 会 将 记 录 文 件 删 除 。
-h|--help 打 印 smbd的 命 令 行 参 数 (用 法 )。

-b

Prints information about how Samba was built.

-l <log directory>

If specified, log directory specifies a log directory into which the "log.smbd" log file will be created for informational and debug messages from the running server. The log file generated is never removed by the server although its size may be controlled by the max log size option in the smb.conf(5) file. Beware: If the directory specified does not exist, smbd will log to the default debug log location defined at compile time.

The default log directory is specified at compile time.

-p <port number>

port number 端 口 号 是 个 正 值 整 数 。 如 果 此 选 项 未 指 定 则 缺 省 值 为 139。 这 个 端 口 号 用 于 从 客 户 端 建 立 对 服 务 器 的 连 接 。 基 于 TCP上 的 SMB所 用 的 标 准 (通 常 使 用 的 )端 口 号 为 139, 因 此 这 是 缺 省 值 。 如 果 你 希 望 作 为 普 通 用 户 而 不 是 root身 份 运 行 服 务 器 的 话 , 多 数 系 统 会 要 求 你 使 用 1024以 上 的 端 口 号 - 如 有 此 情 况 请 向 系 统 管 理 员 取 得 帮 助 。 为 了 使 更 多 客 户 使 用 服 务 器 , 而 又 在 139以 外 的 端 口 进 行 配 置 , 则 你 需 要 在 端 口 139上 进 行 端 口 重 定 向 , 在 rfc1002.txt的 4.3.5部 分 有 详 细 的 描 述 。 除 上 述 情 况 以 外 , 此 选 项 通 常 不 用 。

文 件 FILES

/etc/inetd.conf 如 果 通 过 inetd 超 级 进 程 来 运 行 服 务 器 , 则 此 文 件 必 须 含 有 适 当 的 启 动 信 息 。
/etc/rc

(或 其 它 你 的 系 统 所 用 的 初 始 化 脚 本 )。 如 果 在 启 动 时 以 后 台 进 程 模 式 运 行 服 务 器 , 则 此 文 件 须 包 含 适 当 的 服 务 器 启 动 次 序 。

/etc/services 如 果 通 过 inetd超 级 进 程 来 运 行 服 务 器 , 则 此 文 件 必 须 包 含 一 份 服 务 端 口 (如 139)和 协 议 类 型 (如 tcp)与 对 应 的 服 务 名 (如 netbios-ssn)的 映 射 。
/usr/local/samba/lib/smb.conf
缺 省 的 服 务 器 配 置 文 件 smb.conf(5)的 存 放 位 置 。 系 统 安 装 此 文 件 的 其 它 通 常 位 置 为 /usr/samba/lib/smb.conf/etc/samba/smb.conf。 此 文 件 描 述 了 客 户 可 获 得 的 服 务 项 的 情 况 。 参 见 smb.conf(5)获 得 更 多 情 况 。

限 制 LIMITATIONS

在 有 些 系 统 上 , smbd无 法 在 一 次 setuid()调 用 以 后 把 uid返 回 到 root。 这 样 的 系 统 称 为 “陷 门 ”(trapdoor)uid系 统 。 如 果 你 使 用 这 样 的 系 统 , 将 无 法 同 时 在 一 个 客 户 端 (如 一 台 PC机 )以 两 个 不 同 的 用 户 身 份 进 行 连 接 。 试 图 连 接 第 二 个 用 户 将 得 到 “访 问 被 拒 ”或 类 似 的 结 果 。

环 境 变 量 ENVIRONMENT VARIABLES

PRINTER 如 果 对 可 打 印 服 务 没 有 指 定 打 印 名 称 , 多 数 系 统 将 使 用 此 变 量 (如 果 未 定 义 此 变 量 则 用 lp )的 值 作 为 可 用 打 印 机 的 名 称 。 但 并 不 是 服 务 器 特 定 的 。

PAM INTERACTION

Samba uses PAM for authentication (when presented with a plaintext password), for account checking (is this account disabled?) and for session management. The degree too which samba supports PAM is restricted by the limitations of the SMB protocol and the obey pam restrictions smb.conf(5) paramater. When this is set, the following restrictions apply:

Account Validation: All accesses to a samba server are checked against PAM to see if the account is vaild, not disabled and is permitted to login at this time. This also applies to encrypted logins.

Session Management: When not using share level secuirty, users must pass PAM’s session checks before access is granted. Note however, that this is bypassed in share level secuirty. Note also that some older pam configuration files may need a line added for session support.

版 本 VERSION

此 手 册 页 是 针 对 samba套 件 版 本 3.0的 。

诊 断 DIAGNOSTICS

通 常 情 况 下 诊 断 信 息 都 记 录 到 指 定 好 的 记 录 文 件 中 。 这 个 文 件 的 名 称 是 在 编 译 时 指 定 的 , 但 也 可 以 用 命 令 行 来 指 定 。 用 户 可 以 得 到 的 诊 断 信 息 的 数 量 和 种 类 取 决 于 用 户 执 行 客 户 端 程 序 时 所 用 的 调 试 等 级 。 如 果 你 发 现 有 问 题 的 话 , 把 调 试 级 设 到 3并 详 细 阅 读 记 录 文 件 里 的 内 容 。 很 多 信 息 都 无 须 加 以 说 明 。 不 幸 的 是 , 在 写 手 册 页 时 , 源 代 码 中 有 着 太 多 的 诊 断 信 息 , 它 们 保 证 了 对 每 种 情 况 都 加 以 描 述 , 却 无 法 写 入 文 档 。 在 此 时 , 你 最 好 还 是 用 grep查 找 源 代 码 并 检 查 引 起 诊 断 信 息 的 条 件 。

信 号 SIGNALS

smbd发 送 一 个 SIGHUP信 号 可 以 使 它 在 一 个 很 短 时 间 内 重 新 装 入 smb.conf配 置 文 件 。 我 们 推 荐 你 使 用 SIGKILL (-9)来 终 止 smbd进 程 除 非 这 是 最 后 的 方 法 , 因 为 这 样 做 可 能 导 致 名 字 数 据 库 不 一 致 。 正 确 的 方 法 是 发 送 SIGTERM (-15)信 号 并 等 待 程 序 自 行 结 束 。 另 外 , smbd程 序 的 调 试 记 录 等 级 也 可 以 通 过 smbcontrol(1) 调 高 或 者 调 低 。 (向 程 序 发 送 一 个 SIGUSR1或 SIGUSR2信 号 (kill -USR2 <nmbd-pid>)的 方 法 在 Samba2.2 中 已 经 不 再 使 用 。 ) 通 过 使 用 这 样 的 方 法 可 以 诊 断 一 些 暂 时 的 问 题 , 同 时 仍 然 可 以 在 一 个 正 常 的 并 且 较 低 的 记 录 等 级 来 运 行 。

Note that as the signal handlers send a debug write, they are not re-entrant in smbd. This you should wait untilsmbd is in a state of waiting for an incoming SMB before issuing them. It is possible to make the signal handlers safe by un-blocking the signals before the select call and re-blocking them after, however this would affect performance.

参 见 SEE ALSO

hosts_access(5), inetd(8), nmbd(8), smb.conf(5), smbclient(1), testparm(1), testprns(1), 还 有 互 联 网 草 案 rfc1001.txt, rfc1002.txt. 另 外 , CIFS (从 前 的 SMB) 规 约 可 以 在 http://samba.org/cifs/网; 页 上 找 到 链 接 。

作 者 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