Man page - lsblk(8)

Packages contains this manual

Available languages:

en pl ja uk ro sr de

Manual

LSBLK

名 前
書 式
説 明
オ プ シ ョ ン
注 記
リ タ ー ン コ ー ド
作 者
環 境 変 数
関 連 項 目
入 手 方 法

名 前

lsblk - ブ ロ ッ ク デ バ イ ス を 一 覧 表 示 す る

書 式

lsblk [options] [ device ...]

説 明

lsblk は 、 利 用 で き る す べ て の ブ ロ ッ ク デ バ イ ス 、 ま た は 指 定 さ れ た ブ ロ ッ ク デ バ イ ス の 情 報 を 一 覧 表 示 す る 。 lsblk コ マ ン ド は 、 sysfs フ ァ イ ル シ ス テ ム や udev の デ ー タ ベ ー ス を 読 ん で 、 情 報 を 収 集 す る 。 udev の デ ー タ ベ ー ス が 利 用 で き な い 場 合 や 、 lsblk が udev の サ ポ ー ト な し で コ ン パ イ ル さ れ て い る 場 合 は 、 ブ ロ ッ ク デ バ イ ス か ら 直 接 LABEL, UUID, フ ァ イ ル シ ス テ ム タ イ プ な ど を 読 み 取 ろ う と す る 。 そ の 場 合 は 、 ル ー ト 権 限 が 必 要 で あ る 。

こ の コ マ ン ド は 、 デ フ ォ ル ト で は 、 す べ て の ブ ロ ッ ク デ バ イ ス を ツ リ ー 状 の フ ォ ー マ ッ ト で 表 示 す る (RAM デ ィ ス ク は 除 く )。 利 用 で き る す べ て の 項 目 (columns) の リ ス ト を 見 る に は 、 lsblk --help を 使 用 す れ ば よ い 。

デ フ ォ ル ト の 出 力 は も と よ り 、 --fs や --topology と い っ た オ プ シ ョ ン の デ フ ォ ル ト の 出 力 も 、 バ ー ジ ョ ン に よ っ て 違 う こ と が あ る 。 そ こ で 、 ス ク リ プ ト で 使 う と き は 、 デ フ ォ ル ト の 出 力 の 使 用 は 、 な る べ く 避 け た 方 が よ い 。 い つ で も 一 定 の 出 力 が 必 要 な 場 合 に は 、 --output column-list と --list を 使 用 し て 、 表 示 さ せ た い 項 目 が 何 と 何 か を 、 必 ず 明 確 に 指 定 す る べ き で あ る 。

lsblk を 実 行 し た と き 、 デ バ イ ス が つ い 今 し が た 追 加 、 変 更 さ れ た ば か り で 、 そ う し た デ バ イ ス に つ い て の 情 報 の す べ て を 、 udev が ま だ 取 得 し て い な い 、 と い う こ と が あ る か も し れ な い 。 そ う し た 場 合 に は 、 現 状 と udev と を 同 期 さ せ る た め に 、 lsblk を 使 用 す る 前 に 、 udevadm settle を 実 行 す る こ と を お 勧 め す る 。

オ プ シ ョ ン

-a , --all

空 っ ぽ の デ バ イ ス や RAM デ ィ ス ク デ バ イ ス も リ ス ト す る 。

-b , --bytes

SIZE の 項 目 (column) を 人 間 に 読 み や す い 表 記 で は な く 、 バ イ ト 単 位 で 表 示 す る 。

-D , --discard

各 デ バ イ ス に つ い て 、 そ の デ ィ ス カ ー デ ィ ン グ 能 力 (discarding capabilities、 TRIM や UNMAP) の 情 報 を 表 示 す る 。

-d , --nodeps

ホ ル ダ ー デ バ イ ス (holder devices) や ス レ ー ブ を 表 示 し な い 。 た と え ば 、 lsblk --nodeps /dev/sda は 、 sda と い う デ バ イ ス の 情 報 し か 表 示 し な い 。

-E , --dedup column

出 力 さ れ る ツ リ ー の 重 複 を な く す た め に 、 項 目 column を 重 複 排 除 キ ー と し て 使 用 す る 。 た だ し 、 そ の デ バ イ ス で そ の キ ー が 利 用 で き な い 場 合 や 、 そ の デ バ イ ス が パ ー テ ィ シ ョ ン で あ り 、 デ ィ ス ク 全 体 で あ る 親 デ バ イ ス が 同 じ キ ー の 値 を 示 し て い る 場 合 に は 、 そ の デ バ イ ス は や は り 表 示 さ れ る こ と に な る 。

よ く 使 わ れ る 例 と し て は 、 シ ス テ ム の マ ル チ パ ス デ バ イ ス で 、 た と え ば -E WWN を 指 定 し て 、 出 力 の 重 複 を な く す と い っ た こ と が あ る 。

-e , --exclude list

list で 指 定 さ れ た デ バ イ ス を 表 示 か ら 除 外 す る 。 list は 、 コ ン マ で 区 切 っ た メ ー ジ ャ ー デ バ イ ス 番 号 の リ ス ト で あ る 。 な お 、 RAM デ ィ ス ク (major=1) は 、 --all が 指 定 さ れ な い か ぎ り 、 デ フ ォ ル ト で 除 外 さ れ て い る 。 こ の フ ィ ル タ ー で 適 用 対 象 に 指 定 さ れ る の は 、 ト ッ プ レ ベ ル の デ バ イ ス だ け で あ る 。 そ の た め 、 デ バ イ ス の 階 層 関 係 を は っ き り 示 さ な い --list の 出 力 形 式 で は 、 パ ー テ ィ シ ョ ン ま で 表 示 さ れ な く な る こ と に 戸 惑 う か も し れ な い 。

-f , --fs

フ ァ イ ル シ ス テ ム の 情 報 を 表 示 す る 。 こ の オ プ シ ョ ン は 、 -o NAME,FSTYPE,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINT と 等 価 で あ る 。 な お 、 フ ァ イ ル シ ス テ ム や RAID に つ い て の 信 頼 で き る 確 か な 情 報 は 、 blkid コ マ ン ド が 提 供 し て い る (訳 注 : blkid は 、 root に よ っ て 実 行 さ れ た 場 合 、 必 要 に 応 じ て 、 キ ャ ッ シ ュ で は な く 、 デ バ イ ス そ の も の か ら 情 報 を 収 集 す る の で 、 そ の 分 信 頼 性 が 高 い )。

-h , --help

ヘ ル プ テ キ ス ト を 表 示 し て 終 了 す る 。

-I , --include list

list で 指 定 さ れ た デ バ イ ス を 表 示 の 対 象 に す る 。 list は 、 コ ン マ で 区 切 っ た メ ー ジ ャ ー デ バ イ ス 番 号 の リ ス ト で あ る 。 こ の フ ィ ル タ ー で 適 用 対 象 に 指 定 さ れ る の は 、 ト ッ プ レ ベ ル の デ バ イ ス だ け で あ る 。 そ の た め 、 デ バ イ ス の 階 層 関 係 を は っ き り 示 さ な い --list の 出 力 形 式 で は 、 パ ー テ ィ シ ョ ン ま で 表 示 さ れ る よ う に な る こ と に 戸 惑 う か も し れ な い 。

-i , --ascii

ツ リ ー 状 の 表 示 に す る の に ASCII 文 字 を 用 い る 。

-J , --json

JSON 出 力 フ ォ ー マ ッ ト を 使 用 す る 。 --output を 一 緒 に 使 う こ と を 強 く お 勧 め す る 。 必 要 な ら ば 、 --tree も 。

-l , --list

一 覧 表 (list) 形 式 で 出 力 を 表 示 す る 。 こ の 出 力 は 、 デ バ イ ス 間 に ど ん な 関 係 が あ る か を 明 示 し な い 。 ま た 、 バ ー ジ ョ ン 2.34 以 来 、 デ バ イ ス は ど れ も 1 度 し か 表 示 さ れ な い よ う に な っ て い る

[ 訳 注 ]

--list は 、 --pairs や --raw と 一 緒 に 使 う こ と が で き な い 。

-M , --merge

RAID や マ ル チ パ ス デ バ イ ス に つ い て 、 出 力 を 読 み や す く す る た め に 、 サ ブ ツ リ ー の ペ ア レ ン ト を グ ル ー プ 化 す る 。 出 力 は ツ リ ー 状 で あ る 必 要 が あ る 。

-m , --perms

デ バ イ ス の 所 有 者 、 グ ル ー プ 、 許 可 属 性 に つ い て 情 報 を 出 力 す る 。 こ の オ プ シ ョ ン は 、 -o NAME,SIZE,OWNER,GROUP,MODE と 等 価 で あ る 。

-n , --noheadings

ヘ ッ ダ 行 を 表 示 し な い 。

-o , --output list

出 力 に ど の 項 目 (columns) を 表 示 す る か を 指 定 す る 。 使 用 で き る 全 項 目 の リ ス ト を 知 る に は 、 --help オ プ シ ョ ン を 使 用 す れ ば よ い 。 選 択 し た 項 目 に よ っ て は 、 ツ リ ー 状 の 出 力 に 変 化 が 生 ず る か も し れ な い 。 デ フ ォ ル ト で は 、 ’NAME’ の 項 目 に ツ リ ー 出 力 を 使 用 し て い る ( --tree も 参 照 し て い た だ き た い )。

list を +list の 形 で 指 定 す れ ば 、 デ フ ォ ル ト の リ ス ト に 項 目 を 追 加 す る こ と が で き る (た と え ば 、 lsblk -o +UUID の よ う に )。

-O , --output-all

使 用 で き る す べ て の 項 目 を 出 力 す る 。

-P , --pairs

key="value" の 対 の 形 で 出 力 を 表 示 す る 。 問 題 を 起 こ し か ね な い 文 字 は 、 す べ て 16 進 数 に エ ス ケ ー プ さ れ る (\x<code>)。

-p , --paths

デ バ イ ス の フ ル パ ス を 表 示 す る 。

-r , --raw

「 生 の 」 フ ォ ー マ ッ ト で 出 力 を 表 示 す る 。 NAME, KNAME, LABEL, PARTLABEL, MOUNTPOINT と い っ た 項 目 に お け る 、 問 題 を 起 こ し か ね な い 文 字 は 、 す べ て 16 進 数 に エ ス ケ ー プ さ れ る (\x<code>)。

[ 訳 注 ]

「 生 の 」 フ ォ ー マ ッ ト (raw format) と い う の は 、 未 加 工 の 出 力 フ ォ ー マ ッ ト 、 す な わ ち 、 最 小 限 の 整 形 し か し な い フ ォ ー マ ッ ト の こ と 。 ち な み に raw の 反 対 語 は cooked で あ る 。

-S , --scsi

SCSI デ バ イ ス に 関 す る 情 報 の み を 出 力 す る 。 す べ て の パ ー テ ィ シ ョ ン 、 ス レ ー ブ 、 ホ ル ダ ー デ バ イ ス は 無 視 さ れ る 。

-s , --inverse

依 存 関 係 を 逆 の 順 番 で 表 示 す る 。 --list 出 力 が 要 求 さ れ た 場 合 で も 、 出 力 さ れ る 行 は 、 や は り 依 存 関 係 に 従 っ て 並 べ ら れ る 。

-T , --tree [ = column ]

強 制 的 に ツ リ ー 状 の 出 力 フ ォ ー マ ッ ト に す る 。 column が 指 定 さ れ て い れ ば 、 そ の 項 目 で ツ リ ー 表 示 が 行 わ れ る (訳 注 : 現 在 の と こ ろ 、 column の 指 定 は 必 須 )。 デ フ ォ ル ト で ツ リ ー 表 示 さ れ る の は 、 NAME の 項 目 で あ る 。

-t , --topology

ブ ロ ッ ク デ バ イ ス の ト ポ ロ ジ ー に つ い て 情 報 を 出 力 す る 。 こ の オ プ シ ョ ン は 、 -o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA, SCHED,RQ-SIZE,RA,WSAME と 等 価 で あ る 。

-V , --version

バ ー ジ ョ ン 情 報 を 表 示 し て 終 了 す る 。

-x , --sort column

column の 項 目 を 使 っ て 、 出 力 行 を ソ ー ト す る 。 こ の オ プ シ ョ ン は 、 デ フ ォ ル ト で は --list 出 力 フ ォ ー マ ッ ト を 有 効 に す る 。 --tree オ プ シ ョ ン を 使 用 し て 、 強 制 的 に ツ リ ー 状 の 出 力 に す る こ と も 可 能 で あ り 、 そ の 場 合 は 、 ツ リ ー 表 示 の 枝 が 、 column の 値 を 元 に し て ソ ー ト さ れ る 。

-z , --zoned

各 デ バ イ ス に つ い て zone model を 表 示 す る 。

--sysroot directory

lsblk コ マ ン ド が 実 行 さ れ て い る イ ン ス タ ン ス 以 外 の Linux イ ン ス タ ン ス に つ い て デ ー タ を 収 集 す る 。 指 定 す る デ ィ レ ク ト リ は 、 調 査 対 象 と な る Linux イ ン ス タ ン ス の シ ス テ ム ル ー ト で あ る 。 こ の オ プ シ ョ ン は 、 テ ス ト 用 で あ る 。

注 記

個 々 の パ ー テ ィ シ ョ ン に 対 し て 、 あ る 種 の 情 報 (た と え ば 、 キ ュ ー 属 性 , queue attribures) は 、 親 デ バ イ ス か ら 継 承 さ れ る 。

lsblk コ マ ン ド で は 、 各 ブ ロ ッ ク デ バ イ ス を major:minor 番 号 に よ っ て 検 索 で き る 必 要 が あ り 、 そ れ は /sys/dev/block を 使 っ て 行 わ れ る 。 こ の sysfs の block デ ィ レ ク ト リ が 登 場 し た の は 、 カ ー ネ ル 2.6.27 (2008 年 10 月 ) だ っ た 。 十 分 に 新 し い カ ー ネ ル で 問 題 が 生 じ る 場 合 は 、 カ ー ネ ル を ビ ル ド し た と き に 、 CONFIG_SYSFS を 有 効 に し た か ど う か を 確 認 し た 方 が よ い 。

リ タ ー ン コ ー ド

0

成 功

1

失 敗

32

指 定 さ れ た デ バ イ ス が 一 つ も 見 つ か ら な か っ た

64

指 定 さ れ た デ バ イ ス の う ち に 、 見 つ か っ た も の も あ り 、 見 つ か ら な い も の も あ っ た

作 者

Milan Broz <mbroz@redhat.com>
Karel Zak <kzak@redhat.com>

環 境 変 数

LSBLK_DEBUG=all

lsblk デ バ ッ グ 出 力 を 有 効 に す る 。

LIBBLKID_DEBUG=all

libblkid デ バ ッ グ 出 力 を 有 効 に す る 。

LIBMOUNT_DEBUG=all

libmount デ バ ッ グ 出 力 を 有 効 に す る 。

LIBSMARTCOLS_DEBUG=all

libsmartcols デ バ ッ グ 出 力 を 有 効 に す る 。

LIBSMARTCOLS_DEBUG_PADDING=on

目 に 見 え る 埋 め 文 字 (padding characters) を 使 用 す る 。 LIBSMARTCOLS_DEBUG 有 効 に し て お く 必 要 が あ る 。

関 連 項 目

ls (1), blkid (8), findmnt (8)

入 手 方 法

こ の lsblk コ マ ン ド は 、 util-linux パ ッ ケ ー ジ の 一 部 で あ り 、 次 の URL か ら 入 手 で き る 。 https://www.kernel.org/pub/linux/utils/util-linux/