1 ファイル形式とは?
.1 ファイルは、Unix マニュアルページをプレーンテキスト形式で保存します。特にセクション 1(実行プログラムおよびユーザーコマンド)用です。これらは一般に man ページと呼ばれ、man マクロパッケージ(groff)を使用した .roff マークアップで記述されています。レンダリング時には、.TH、.SH、.B、.TP などのドットで始まるディレクティブがレイアウトを制御します。
man ページは、Unix ターミナルで man アプリケーション名 を実行することで閲覧できます。数字の拡張子はマニュアルのセクションを示しています。.1 はユーザーコマンドをカバーし、.2 から .8 はそれぞれシステムコール、ライブラリ関数、ファイル形式、ゲーム、管理コマンドをカバーします。すべてのセクションは、同じ基盤となる roff ソース形式を共有しています。
man ページファイルは圧縮して保存される場合があります。ほとんどの Linux および macOS システムでは、/usr/share/man/man1/ls.1.gz のようなパスに配置され、man コマンドによって必要に応じて解凍されます。.gz 圧縮は、ユーザーの視点からは意識されません。
Windows では異なるヘルプシステムが使用されます。グラフィカルモードでは F1 キーを押すことでヘルプにアクセスし、PowerShell からはコマンドに /? または -? を追加してアクセスします。Windows 上で Unix スタイルの man ページを利用する場合、Windows Subsystem for Linux (WSL) が完全な man および groff 環境を提供します。当然ながら、プラットフォームを問わず、表示する前に特定のアプリケーション用の man ページファイルがインストールされている必要があります。
セキュリティと安全性
リスク: LOWman ページのソースはプレーンテキストであり、閲覧時に実行されることはありません。唯一の理論的な注意点は、roff がチューリング完全なマクロ言語であり、groff に歴史的にパースのバグがあったことです。そのため、完全に信頼できないソースからの .1 ファイルをレンダリングする場合は、フル機能の groff よりも安全でサンドボックス化された mandoc を使用するのが最善です。通常の使用(パッケージやプロジェクトのドキュメントを読む)では、.1 ファイルは無害です。テキストエディタで開くことは完全に安全です。
形式の詳細
概要1 ファイルを開くプログラム
技術的詳細
詳細仕様| フォーマットタイプ | man マクロパッケージを使用したプレーンテキストの roff/groff ソース |
| エンコーディング | ASCII または UTF-8 プレーンテキスト。バイナリヘッダーや BOM は不要 |
| MIME タイプ | text/troff (application/x-troff-man としても受け入れられます) |
| ファイルシグネチャ | バイナリの magic bytes はありません。man ソースは慣習的に .TH タイトル行(例:.TH LS 1)で始まります |
| 対象マニュアルセクション | セクション 1 - 実行プログラムおよび一般ユーザーコマンド |
| マークアップマクロ | .TH (タイトル/ヘッダー), .SH (セクション見出し), .B (太字), .I (斜体), .TP (タグ付き段落), .PP (段落区切り) |
| ディスク上の保存 | Linux では通常 name.1.gz として gzip 圧縮され、/usr/share/man/man1/ 以下に保存されます |
| 一般的な非圧縮サイズ | 1 KB - 100 KB |
| レンダラー / ビューア | groff または nroff によって処理され、ターミナルの man コマンド経由で表示されます |
| 標準的なページ構造 | 必須セクション:NAME, SYNOPSIS, DESCRIPTION。一般的な追加:OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| 兄弟セクションの拡張子 | .2 (システムコール), .3 (ライブラリ関数), .5 (ファイル形式), .8 (システム管理) |
| 関連オペレーティングシステム | Linux, macOS, BSD 系。Windows では WSL (Windows Subsystem for Linux) 経由で利用可能 |
| 開発者 / 維持者 | ベル研究所で誕生 (1971年)。groff 実装は GNU Project によって維持されています |
| 整形済みバリアント | 一部の .1 ファイルは cat ページです。これは roff ソースではなく、バックスペース・オーバーストライクによる太字を含むレンダリング済みテキストです |
| リリース日 | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| 最新バージョン | N/A (roff/man-macro convention; groff is the active implementation) |
| オープンスタンダード | はい · ロイヤリティフリー |
| 仕様書 | man7.org |
1 の変換
コミュニティ Q&A
ユーザーからの質問まだ質問はありません。1 ファイルについて最初の質問をしてみましょう。