Manpages

______________________________________________________________________________

NAME

file - 操 縱 文 件 名 和 屬 性

總 覽 SYNOPSIS

file option name ?arg arg ...? _________________________________________________________________

描 述 DESCRIPTION

這 個 命 令 提 供 在 一 個 文 件 名 或 屬 性 上 的 一 些 操 作 。 Name 是 一 個 文 件 的 名 字 ; 如 果 它 以 波 浪 線 (~)開 始 , 則 在 執 行 命 令 之 前 進 行 波 浪 線 替 換 (詳 情 參 見 filename 命 令 的 手 冊 條 目 )。 Option 指 示 對 文 件 名 做 什 麼 處 理 。 接 受 option 的 任 何 唯 一 的 縮 寫 。 有 效 的 選 項 是 :

file atime name ?time? 返 回 一 個 十 進 制 字 符 串 , 給 出 文 件 name 上 次 被 訪 問 的 時 間 。 如 果 指 定 了 time, 它 是 這 個 文 件 要 設 置 成 的 訪 問 時 間 。 這 個 時 間 是 用 標 準 的 POSIX 方 式 (fashion)度 量 的 , 即 從 一 個 固 定 的 開 始 時 間 至 今 的 秒 數 (通 常 是 1970年 1月 1日 )。 如 果 文 件 不 存 在 或 它 的 訪 問 時 間 不 可 查 詢 或 設 置 則 生 成 一 個 錯 誤 。 在 Windows 上 , FAT 文 件 系 統 不 支 持 訪 問 時 間 。
file attributes
name

file attributes name ?option?
file attributes
name ?option value option value...? 這 個 子 命 令 返 回 或 設 置 與 一 個 文 件 相 關 聯 的 特 定 於 平 臺 的 值 。 第 一 種 形 式 返 回 特 定 於 平 臺 的 標 誌 (flag)和 它 們 的 值 的 一 個 列 表 。 第 二 種 形 式 返 回 指 定 選 項 的 值 。 第 三 種 形 式 設 置 一 個 或 多 個 值 。 這 些 值 是 : 在 Unix 上 , -group 得 到 或 設 置 這 個 文 件 的 組 名 字 。 給 這 個 命 令 一 個 組 ID, 而 它 返 回 一 個 組 名 字 。 -owner 得 到 或 設 置 這 個 文 件 的 屬 主 的 名 字 。 這 個 命 令 返 回 屬 主 的 名 字 , 而 在 設 置 屬 主 的 時 候 要 傳 遞 給 它 數 值 的 ID。 -permissions 設 置 或 查 詢 chmod(1) 所 使 用 的 八 進 制 代 碼 。 這 個 命 令 還 有 限 的 支 持 使 用 chmod(1)的 符 號 屬 性 來 做 設 置 , 形 式 是 [ugo]?[[+-=][rwxst],[...]], 這 裏 使 用 逗 號 來 分 隔 多 個 符 號 屬 性 (例 如 : u+s, go-rw 爲 用 戶 添 加 粘 住 位 (sticky), 爲 組 和 其 他 刪 除 讀 和 寫 的 許 可 權 )。 還 支 持 一 個 簡 化 的 ls式 樣 的 字 符 串 , 形 式 是 rwxrwxrwx (必 須 是 9 個 字 符 )(例 如 : rwxr-xr-t 等 價 於 01755)。 在 Windows 上 , -archive 給 出 值 或 設 置 或 清 除 這 個 文 件 的 歸 檔 屬 性 。 -hidden 給 出 值 或 設 置 或 清 除 這 個 文 件 的 隱 藏 屬 性 。 -longname將 把 每 個 路 徑 元 素 擴 展 成 長 版 本 。 不 能 設 置 這 個 屬 性 。 -readonly 給 出 值 或 設 置 或 清 除 這 個 文 件 的 只 讀 屬 性 。 -shortname 給 出 一 個 字 符 串 , 在 這 裏 每 個 路 徑 元 素 被 替 換 成 它 的 短 (8.3)版 本 的 文 件 名 。 不 能 設 置 這 個 屬 性 。 -system 給 出 值 或 設 置 或 清 除 這 個 文 件 的 系 統 屬 性 。 在 Macintosh 上 , -creator給 出 或 設 置 這 個 文 件 的 尋 找 器 (Finder)建 立 者 類 型 。 -hidden給 出 值 或 設 置 或 清 除 這 個 文 件 的 隱 藏 屬 性 。 -readonly 給 出 值 或 設 置 或 清 除 這 個 文 件 的 只 讀 屬 性 。 注 意 如 果 打 開 了 文 件 共 享 則 目 錄 只 能 被 鎖 定 。 -type 給 出 或 設 置 這 個 文 件 的 尋 找 器 文 件 類 型 。

file channels ?pattern? 如 果 沒 有 指 定 pattern, 則 返 回 所 有 在 這 個 解 釋 器 中 註 冊 的 打 開 通 道 的 一 個 列 表 。 如 果 指 定 了 pattern, 則 只 返 回 匹 配 pattern 的 名 字 。 確 定 匹 配 使 用 與 string match 相 同 的 規 則 。
file copy
?-force? ?--? source target

file copy ?-force? ?--? source ?source ...? targetDir 第 一 中 形 式 在 路 徑 名 target 底 下 做 文 件 或 路 徑 source的 一 個 復 件 。 如 果 target 是 一 個 現 存 的 目 錄 , 則 使 用 第 二 種 形 式 。 第 二 種 形 式 在 targetDir 中 做 列 出 的 每 個 source 文 件 的 一 個 復 件 。 如 果 指 定 一 個 目 錄 作 爲 一 個 source, 則 這 個 目 錄 的 內 容 將 被 遞 歸 的 複 製 進 targetDir 中 。 除 非 指 定 -force 選 項 否 則 現 存 文 件 將 不 被 覆 寫 。 即 使 指 定 了 -force , 嘗 試 覆 寫 一 個 非 空 目 錄 , 用 一 個 文 件 覆 寫 一 個 目 錄 , 或 者 用 一 個 目 錄 覆 寫 一 個 文 件 將 導 致 錯 誤 。 參 數 按 指 定 的 次 序 被 處 理 , 如 果 有 錯 誤 的 話 , 在 第 一 個 錯 誤 處 停 止 (halt)。 一 個 -- 標 記 選 項 的 結 束 ; 在 -- 之 後 的 參 數 即 使 以 - 開 始 將 仍 被 作 爲 一 個 source 來 對 待 。

file delete ?-force? ?--? pathname ?pathname ... ? 刪 除 由 每 個 pathname 參 數 所 指 定 的 文 件 或 目 錄 。 只 有 指 定 -force選 項 才 刪 除 非 空 目 錄 。 嘗 試 刪 除 一 個 不 存 在 文 件 將 導 致 不 作 爲 一 個 錯 誤 來 考 慮 。 即 使 沒 有 指 定 -force 項 , 嘗 試 刪 除 一 個 只 讀 文 件 將 導 致 文 件 被 刪 除 。 參 數 按 指 定 的 次 序 被 處 理 , 如 果 有 錯 誤 的 話 , 在 第 一 個 錯 誤 處 停 止 (halt)。 一 個 -- 標 記 選 項 的 結 束 ; 在 -- 之 後 的 參 數 即 使 以 - 開 始 將 仍 被 作 爲 一 個 pathname來 對 待 。
file dirname
name 返 回 一 個 名 字 , 由 在 name 中 除 了 最 後 一 個 之 外 的 所 有 路 徑 組 成 部 分 (component)組 成 。 如 果 name 是 一 個 相 對 的 文 件 名 並 且 只 包 含 一 個 路 徑 元 素 (element), 則 返 回 “.” (在 Macintosh 上 爲 “:”)。 如 果 name 參 照 一 個 根 目 錄 , 則 返 回 根 目 錄 。 例 如 ,

file dirname c:/ 返 回c:/. 注 意 波 浪 線 替 換 隻 在 必 要 的 時 候 進 行 用 以 補 全 (complete)命 令 。 例 如 ,
file dirname ~/src/foo.c
返 回~/src, 而
file dirname ~
返 回/home (or something similar).

file executable name 如 果 文 件 對 當 前 用 戶 是 可 執 行 的 則 返 回 1, 否 則 返 回 0
file exists
name 如 果 文 件 name 存 在 並 且 當 前 的 用 戶 對 找 到 (lead to)它 (所 途 徑 )的 目 錄 有 查 找 的 權 利 (privilege)則 返 回 1, 否 則 返 回 0
file extension
name 返 回 在 name 最 後 那 個 元 素 的 最 後 一 個 點 號 之 後 幷 包 括 點 號 的 所 有 在 name中 字 符 。 如 果 在 name 的 最 後 的 那 個 元 素 中 沒 有 點 號 則 返 回 空 串 。
file isdirectory
name 如 果 文 件 name 是 一 個 目 錄 則 返 回 1, 否 則 返 回 0
file isfile
name 如 果 文 件 name 是 一 個 普 通 文 件 則 返 回 1, 否 則 返 回 0
file join
name ?name ...? 接 受 一 個 或 多 個 文 件 名 並 使 用 對 當 前 平 臺 正 確 的 路 徑 分 隔 符 來 組 合 它 們 。 如 果 特 定 的 name是 相 對 的 , 則 它 會 被 連 接 到 前 面 的 文 件 名 參 數 上 。 否 則 , 丟 棄 所 有 以 前 的 參 數 , 從 當 前 的 參 數 開 始 進 行 連 接 。 例 如

file join a b /foo bar 返 回/foo/bar. 注 意 任 何 名 字 都 可 以 包 含 分 隔 符 , 並 且 結 果 總 是 依 從 當 前 平 臺 的 規 矩 : 對 Unix 和 Windows 是 /, 對 Macintosh 是 :

file lstat name varName 除 了 使 用 lstat 調 用 而 不 使 用 stat 之 外 , 與 stat 選 項 (見 後 )相 同 。 這 意 味 着 如 果 name 參 照 一 個 符 號 連 接 , 在 varName 中 返 回 的 信 息 是 針 對 這 個 連 接 而 不 是 它 所 引 用 的 那 個 文 件 。 在 不 支 持 符 號 連 接 的 系 統 上 這 個 選 項 的 行 爲 與 stat選 項 完 全 一 致 。
file mkdir
dir ?dir ...? 建 立 每 個 指 定 的 目 錄 。 對 於 每 個 指 定 的 路 徑 名 dir , 象 dir 自 身 一 樣 , 這 個 命 令 將 建 立 所 有 不 存 在 的 父 目 錄 。 如 果 指 定 了 一 個 現 存 的 目 錄 , 不 做 動 作 並 不 返 回 錯 誤 。 嘗 試 用 一 個 目 錄 覆 寫 一 個 現 存 的 文 件 將 導 致 一 個 錯 誤 。 參 數 按 指 定 的 次 序 被 處 理 , 如 果 有 錯 誤 的 話 , 在 第 一 個 錯 誤 處 停 止 (halt)。
file mtime
name ?time? 返 回 一 個 十 進 制 字 符 串 , 給 出 文 件 name上 次 被 修 改 的 時 間 。 如 果 指 定 了 time , 它 是 這 個 文 件 要 設 置 成 的 修 改 時 間 。 (等 價 與 Unix 的 touch)。 這 個 時 間 是 用 標 準 的 POSIX 方 式 (fashion)度 量 的 , 即 從 一 個 固 定 的 開 始 時 間 至 今 的 秒 數 (通 常 是 1970年 1月 1日 )。 如 果 文 件 不 存 在 或 它 的 修 改 時 間 不 可 查 詢 或 設 置 則 生 成 一 個 錯 誤 。
file nativename
name 返 回 文 件 的 特 定 於 平 臺 的 名 字 。 如 果 這 個 文 件 名 需 要 傳 遞 給 特 定 於 系 統 的 調 用 , 比 如 對 在 Windows 下 的 exec 或 在 Macintosh 上 的 AppleScript 將 會 有 用 。
file owned
name 如 果 文 件 name 由 當 前 用 戶 所 有 則 返 回 1, 否 則 返 回 0
file pathtype
name 返 回 absoluterelativevolumerelative 中 的 一 個 。 如 果 name 參 照 一 個 在 指 定 捲 上 的 指 定 文 件 , 路 徑 類 型 將 是 absolute。 如 果 name 參 照 一 個 相 對 當 前 工 作 目 錄 的 一 個 文 件 , 則 路 徑 類 型 將 是 relative。 如 果 name 參 照 在 指 定 捲 上 的 相 對 於 當 前 工 作 目 錄 的 一 個 文 件 , 或 者 在 當 前 工 作 捲 上 的 指 定 文 件 , 則 路 徑 類 型 是 volumerelative
file readable
name 如 果 文 件 name 對 當 前 用 戶 是 可 讀 的 則 返 回 1, 否 則 返 回 0
file readlink
name 返 回 由 name 給 出 的 符 號 連 接 的 值 (比 如 , 它 指 向 的 文 件 的 名 字 )。 如 果 name 不 是 符 號 連 接 或 它 的 值 不 可 讀 , 則 返 回 一 個 錯 誤 。 在 不 支 持 符 號 連 接 的 系 統 上 這 個 選 項 未 定 義 。
file rename
?-force? ?--? source target
file rename
?-force? ?--? source ?source ...? targetDir 第 一 種 形 式 接 受 由 路 徑 名 source 指 定 的 文 件 或 目 錄 並 且 把 它 重 命 名 成 target, 如 果 路 徑 名 target指 定 了 在 不 同 目 錄 下 的 一 個 名 字 , 則 移 動 這 個 文 件 。 如 果 target 是 一 個 現 存 的 目 錄 , 則 使 用 第 二 種 形 式 。 第 二 中 形 式 移 動 每 個 source 文 件 或 目 錄 到 目 錄 targetDir 中 。 除 非 指 定 了 -force選 項 否 則 不 覆 寫 現 存 的 文 件 。 嘗 試 覆 寫 一 個 非 空 目 錄 , 用 一 個 文 件 覆 寫 一 個 目 錄 , 或 者 用 一 個 目 錄 覆 寫 一 個 文 件 將 導 致 錯 誤 。 參 數 按 指 定 的 次 序 被 處 理 , 如 果 有 錯 誤 的 話 , 在 第 一 個 錯 誤 處 停 止 (halt)。 一 個 -- 標 記 選 項 的 結 束 ; 在 -- 之 後 的 參 數 即 使 以 - 開 始 將 仍 被 作 爲 一 個 source 來 對 待 。
file rootname
name 返 回 name 的 最 後 一 個 組 成 部 分 的 最 後 一 個 “.”之 前 但 不 包 括 這 個 “.”的 name中 的 所 有 字 符 。 如 果 name 的 最 後 的 組 成 部 分 不 包 含 點 號 , 則 返 回 name
file size
name 返 回 給 出 文 件 name 的 大 小 的 以 字 節 爲 單 位 的 一 個 十 進 制 字 符 串 。 如 果 文 件 不 存 在 或 它 的 大 小 不 可 查 詢 則 生 成 一 個 錯 誤 。
file split
name 返 回 一 個 列 表 , 它 的 元 素 是 在 name 中 的 路 徑 的 組 成 部 分 。 列 表 的 第 一 個 元 素 將 與 name 有 相 同 的 路 徑 類 型 。 所 有 其 他 元 素 將 是 相 對 的 。 除 了 需 要 確 保 一 個 元 素 是 相 對 的 而 無 歧 義 之 外 , 丟 棄 路 徑 分 隔 符 。 例 如 , 在 Unix 下

file split /foo/~bar/baz 返 回/ foo ./~bar baz 來 確 保 以 後 的 命 令 在 第 三 個 組 成 部 分 上 不 進 行 波 浪 線 替 換 。

file stat name varNamename 上 調 用 stat 內 核 調 用 , 並 且 使 用 由 varName 給 出 的 變 量 來 持 有 從 內 核 調 用 返 回 的 信 息 。 VarName 被 作 爲 一 個 數 組 變 量 來 對 待 , 並 且 給 這 個 變 量 設 置 下 列 元 素 : atimectimedevgidinomodemtimenlinksizetypeuid。 除 了 type之 外 的 每 個 元 素 都 是 一 個 十 進 制 字 符 串 , 它 們 的 值 來 自 從 stat 返 回 的 結 構 中 相 應 的 字 段 。 這 些 值 的 意 義 詳 見 stat 的 手 冊 條 目 。 type 元 素 給 出 的 文 件 類 型 與 命 令 file type 返 回 的 有 相 同 的 形 式 。 這 個 命 令 返 回 一 個 空 串 。
file tail
name 返 回 在 最 後 一 個 目 錄 分 隔 符 之 後 的 在 name中 的 所 有 字 符 。 如 果 name 不 包 含 分 隔 符 則 返 回 name
file type
name 返 回 給 出 文 件 name 的 類 型 的 一 個 字 符 串 , 它 將 是 filedirectorycharacterSpecialblockSpecialfifolink、 或 socket 中 的 一 個 。
file volume
返 回 一 個 適 當 的 Tcl 列 表 , 給 出 到 掛 裝 在 系 統 上 的 卷 的 絕 對 路 徑 。 在 Macintosh上 , 將 是 掛 裝 驅 動 器 的 一 個 列 表 , 包 括 本 地 的 和 網 絡 的 二 者 。 N.B.(?)如 果 兩 個 驅 動 器 有 相 同 的 名 字 , 它 們 都 將 出 現 在 卷 列 表 上 , 但 當 前 沒 有 辦 法 從 Tcl 來 訪 問 除 了 第 一 個 之 外 的 任 何 驅 動 器 。 在 UNIX 上 , 命 令 將 總 是 返 回 "/", 因 爲 所 有 文 件 系 統 都 是 本 地 掛 裝 的 。 在 Windows 上 , 它 將 返 回 可 獲 得 的 本 地 驅 動 器 的 一 個 列 表 (比 如 , {a:/ c:/})。
file writable
name 如 果 文 件 name 對 當 前 用 戶 是 可 寫 的 則 返 回 1, 否 則 返 回 0

移 植 要 點 PORTABILITY ISSUES

Unix 這 些 命 令 總 是 使 用 真 實 用 戶 和 組 標 識 而 不 使 用 有 效 用 戶 和 組 標 識 。

參 見 SEE ALSO

filename

關 鍵 字 KEYWORDS

attributes, copy files, delete files, directory, file, move files, name, rename files, stat

[中 文 版 維 護 人 ]

寒 蟬 退 士

[中 文 版 最 新 更 新 ]

2001/06/21

《 中 國 Linux 論 壇 man 手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh

COMMENTS