.\" partx.8 -- man page for partx
.\" Copyright 2007 Karel Zak <kzak@redhat.com>
.\" Copyright 2007 Red Hat, Inc.
.\" Copyright 2010 Davidlohr Bueso <dave@gnu.org>
.\" May be distributed under the GNU General Public License
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2020 Chonan Yoichi
.\"         all rights reserved.
.\" Translated (util-linux 2.35.2) Fri Aug 14 11:30:44 JST 2020
.\"         by Chonan Yoichi <cyoichi@maple.ocn.ne.jp>
.\"
.TH PARTX 8 "December 2014" util\-linux "System Administration"
.SH 名前
partx \- ディスク上のパーティションについてその存在と番号をカーネルに通知する
.SH 書式
\fBpartx\fP [\fB\-a\fP|\fB\-d\fP|\fB\-P\fP|\fB\-r\fP|\fB\-s\fP|\fB\-u\fP] [\fB\-t\fP \fItype\fP] [\fB\-n\fP
\fIM\fP\fB:\fP\fIN\fP] [\fB\-\fP] \fIdisk\fP
.br
\fBpartx\fP [\fB\-a\fP|\fB\-d\fP|\fB\-P\fP|\fB\-r\fP|\fB\-s\fP|\fB\-u\fP] [\fB\-t\fP \fItype\fP] \fIpartition\fP
[\fIdisk\fP]
.SH 説明
\fBpartx\fP は、引き数としてデバイスやディスクイメージを渡されると、
パーティションテーブルを解析して、その内容を一覧表示しようとする。
また、\fBpartx\fP はカーネルに指示して、あるパーティションをカーネルに登録したり、
登録から削除したりさせることもできる。
.PP
\fIpartition\fP 引き数があるときは、\fIdisk\fP 引き数の指定は任意である
(訳注: \fB\-a\fP オプションでは、両方必要なこともある)。
あるパーティションを、それがディスク全体であるかのようにスキャンさせたいときは
(たとえば、パーティションの中にサブパーティションが入れ子になっていて、そのリストを表示したいときは)、
引き数に "\-" (hyphen\-minus) を使用すればよい。例を挙げよう。

.RS 7
.TP 
partx \-\-show \- /dev/sda3
.RE
.PP
こうすると、sda3 を 1
個のパーティションとしてではなく、ひとつの完全なディスクとして見ることになる。
.PP
\fBpartx は、fdisk プログラムの 1 種ではない。\fPだから、\fBpartx\fP
でパーティションを登録したり、削除したりしても、ディスクが変更されるわけではない。
ディスク上のパーティションについて、その存在と番号をカーネルに知らせているだけなのである。
.SH オプション
.TP 
\fB\-a\fP,\fB \-\-add\fP
指定されたパーティションを登録する。
あるいは、ディスクを読んで、すべてのパーティションを登録する。
.TP 
\fB\-b\fP,\fB \-\-bytes\fP
出力項目 (column) SIZE を、人間が読みやすい形ではなく、バイト単位で表示する。
.TP 
\fB\-d\fP,\fB \-\-delete\fP
指定されたパーティション、またはすべてのパーティションを登録から削除する。
存在しないパーティションを消すのは、間違った使い方ではない。従って、このオプションは、
現在デバイス上にいくつパーティションがあるかを気にすることなく、
広い範囲を指定する \fB\-\-nr\fP オプションと一緒に使うことができる。
.TP 
\fB\-g\fP,\fB \-\-noheadings\fP
\fB\-\-show\fP や \fB\-\-raw\fP オプションを使用したとき、ヘッダ行を表示しない。
.TP 
\fB\-l\fP,\fB \-\-list\fP
パーティションのリストを表示する。すべての数値は、512\-byte
セクター単位の表示であることに注意していただきたい
(訳注: もちろん、SIZE は除く)。この出力フォーマットは非推奨であり、\fB\-\-show\fP
を使った方がよい。これからスクリプトを書くのなら、このオプショを使うべきではない。
.TP 
\fB\-n\fP,\fB \-\-nr \fP\fIM\fP\fB:\fP\fIN\fP
パーティションの範囲を指定する。後方互換のために、\fIM\fP\fB\-\fP\fIN\fP
という書き方も使用できる。範囲にはマイナスの数値が含まれていてもよく、たとえば
\fB\-\-nr \-1:\-1\fP は、最後のパーティションのことであり、\fB\-\-nr \-2:\-1\fP
は、最後の二つのパーティションのことである。範囲の指定には、次のような表現が使える。
.RS 14
.TP 
\fIM\fP
パーティションを 1 個だけ指定する (例 \fB\-\-nr 3\fP)。
.TP 
\fIM\fP\fB:\fP
範囲の下限のみを指定する (例 \fB\-\-nr 2:\fP)。
.TP 
\fB:\fP\fIN\fP
範囲の上限のみを指定する (例 \fB\-\-nr :4\fP)。
.TP 
\fIM\fP\fB:\fP\fIN\fP
範囲の下限と上限を指定する (例 \fB\-\-nr 2:4\fP)。
.RE
.TP 
\fB\-o\fP,\fB \-\-output \fP\fIlist\fP
\fB\-\-show\fP, \fB\-\-pairs\fP, \fB\-\-raw\fP の出力でどんな出力項目 (columns)
を使うかを指定する。何をどんな順番で出力するかを全く指定しない場合は、
デフォルトの配列が使用される。指定できる項目すべてのリストを知るには、\fB\-\-help\fP
オプションを使用すればよい。このオプションは、
\fB\-\-add\fP, \fB\-\-delete\fP, \fB\-\-update\fP, \fB\-\-list\fP
といったオプションと組み合わせて使うことはできない。
(訳注: このオプションの引き数 \fIlist\fP は、出力項目をコンマで区切ったリストである。
また、\fI+list\fP という書式で、デフォルトの出力に項目を追加することもできる。)
.TP 
\fB\-\-output\-all\fP
引き数として渡されたデバイスやパーティションについて、使用できるすべての項目
(columns) を出力する。
.TP 
\fB\-P\fP,\fB \-\-pairs\fP
KEY="value" というフォーマットでパーティションのリストを表示する。
.TP 
\fB\-r\fP,\fB \-\-raw\fP
「生の」出力フォーマットでパーティションのリストを表示する。
.RS
.IP "[\fB訳注\fP]" 8
「生の」出力フォーマット (the raw output format)
というのは、未加工の出力フォーマット、すなわち、最小限の整形しかしないフォーマットのこと。
ちなみに、こうした raw の反対語は cooked である (そんなオプションはないけれど)。
.RE
.TP 
\fB\-s\fP,\fB \-\-show\fP
パーティションのリストを表示する。出力する項目は、\fB\-\-output\fP
オプションを使って選択したり、並べ替えたりすることができる。
(SIZE 以外の) すべての数値は、512\-byte セクタ単位の表記である。
.TP 
\fB\-t\fP,\fB \-\-type \fP\fItype\fP
パーティションテーブルのタイプを指定する。
.TP 
\fB\-\-list\-types\fP
サポートしているパーティションテーブルのタイプを一覧表示して、終了する。
.TP 
\fB\-u\fP,\fB \-\-update\fP
指定されたパーティションを更新 (update) する。
.TP 
\fB\-S\fP,\fB \-\-sector\-size \fP\fIsize\fP
デフォルトのセクタサイズを上書きする。
.TP 
\fB\-v\fP,\fB \-\-verbose\fP
饒舌モード
.TP 
\fB\-V\fP,\fB \-\-version\fP
バージョン情報を表示して終了する。
.TP 
\fB\-h\fP,\fB \-\-help\fP
ヘルプテキストを表示して終了する。
.SH 用例
.nf
partx \-\-show /dev/sdb3
partx \-\-show \-\-nr 3 /dev/sdb
partx \-\-show /dev/sdb3 /dev/sdb
.fi
.RS
この三つのコマンドは、どれも /dev/sdb の 3 番目のパーティションの情報を表示する。
.RE
.nf
partx \-\-show \- /dev/sdb3
.fi
.RS
/dev/sdb3 というパーティションにあるすべてのサブパーティションの情報を表示する
(/dev/sdb3 というデバイスをひとつの完全なディクスと見なす)。
.RE
.nf
partx \-o START \-g \-\-nr 5 /dev/sdb
.fi
.RS
/dev/sdb の 5 番目のパーティションの開始セクタを、ヘッダを付けずに表示する。
.RE
.nf
partx \-o SECTORS,SIZE /dev/sda5 /dev/sda
.fi
.RS
/dev/sda の 5
番目のパーティションの大きさを、セクタ数と人間に読みやすいサイズ表記で表示する。
.RE
.nf
partx \-\-add \-\-nr 3:5 /dev/sdd
.fi
.RS
/dev/sdd の 3 番目から 5 番目までの (両者を含む)
パーティションの内、利用できるのものすべてをカーネルに登録する。
.RE
.nf
partx \-d \-\-nr \-1 /dev/sdd
.fi
.RS
/dev/sdd の最後のパーティションをカーネルの登録から外す。
.RE
.SH 関連項目
\fBaddpart\fP(8), \fBdelpart\fP(8), \fBfdisk\fP(8), \fBparted\fP(8), \fBpartprobe\fP(8)
.SH 作者
Davidlohr Bueso <dave@gnu.org>
.br
Karel Zak <kzak@redhat.com>
.PP
最初のバージョンを書いたのは、Andries E.\& Brouwer <aeb@cwi.nl> だった。
.SH 環境変数
.IP LIBBLKID_DEBUG=all
libblkid デバッグ出力を有効にする。
.SH 入手方法
この partx コマンドは、util\-linux パッケージの一部であり、Linux Kernel Archive
<https://www.kernel.org/pub/linux/utils/util\-linux/>
から入手できる。