.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\" ========================================================================
.\"
.IX Title "virt-cat 1"
.TH virt-cat 1 "2012-06-01" "libguestfs-1.18.1" "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "名前"
.IX Header "名前"
virt-cat \- 仮想マシンにあるファイルの表示
.SH "書式"
.IX Header "書式"
.Vb 1
\& virt\-cat [\-\-options] \-d domname file [file ...]
\&
\& virt\-cat [\-\-options] \-a disk.img [\-a disk.img ...] file [file ...]
.Ve
.PP
古い形式:
.PP
.Vb 1
\& virt\-cat domname file
\&
\& virt\-cat disk.img file
.Ve
.SH "説明"
.IX Header "説明"
\&\f(CW\*(C`virt\-cat\*(C'\fR is a command line tool to display the contents of \f(CW\*(C`file\*(C'\fR where
\&\f(CW\*(C`file\*(C'\fR exists in the named virtual machine (or disk image).
.PP
Multiple filenames can be given, in which case they are concatenated
together.  Each filename must be a full path, starting at the root directory
(starting with '/').
.PP
\&\f(CW\*(C`virt\-cat\*(C'\fR can be used to quickly view a file.  To edit a file, use
\&\f(CW\*(C`virt\-edit\*(C'\fR.  For more complex cases you should look at the \fIguestfish\fR\|(1)
tool (see \*(L"\s-1USING\s0 \s-1GUESTFISH\s0\*(R" below).
.SH "例"
.IX Header "例"
Display \f(CW\*(C`/etc/fstab\*(C'\fR file from inside the libvirt \s-1VM\s0 called \f(CW\*(C`mydomain\*(C'\fR:
.PP
.Vb 1
\& virt\-cat \-d mydomain /etc/fstab
.Ve
.PP
仮想マシンのディスクイメージファイルから syslog メッセージを一覧表示するには:
.PP
.Vb 1
\& virt\-cat \-a disk.img /var/log/messages | tail
.Ve
.PP
Find out what \s-1DHCP\s0 \s-1IP\s0 address a \s-1VM\s0 acquired:
.PP
.Vb 2
\& virt\-cat \-d mydomain /var/log/messages | \e
\&   grep \*(Aqdhclient: bound to\*(Aq | tail
.Ve
.PP
どのパッケージが最新インストールされたかを見つけるには:
.PP
.Vb 1
\& virt\-cat \-d mydomain /var/log/yum.log | tail
.Ve
.PP
どのユーザーが仮想マシンにログインしているかを見つけるには:
.PP
.Vb 2
\& virt\-cat \-d mydomain /var/run/utmp > /tmp/utmp
\& who /tmp/utmp
.Ve
.PP
または、だれがログオンしたかを見つけるには:
.PP
.Vb 2
\& virt\-cat \-d mydomain /var/log/wtmp > /tmp/wtmp
\& last \-f /tmp/wtmp
.Ve
.SH "オプション"
.IX Header "オプション"
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
簡単なヘルプを表示します。
.IP "\fB\-a\fR file" 4
.IX Item "-a file"
.PD 0
.IP "\fB\-\-add\fR file" 4
.IX Item "--add file"
.PD
Add \fIfile\fR which should be a disk image from a virtual machine.  If the
virtual machine has multiple block devices, you must supply all of them with
separate \fI\-a\fR options.
.Sp
ディスクイメージの形式は自動検知されます。これを上書きして強制的に特定の形式を使用するには、\fI\-\-format=..\fR オプションを使用します。
.IP "\fB\-c\fR \s-1URI\s0" 4
.IX Item "-c URI"
.PD 0
.IP "\fB\-\-connect\fR \s-1URI\s0" 4
.IX Item "--connect URI"
.PD
libvirt を使用していると、指定された \fI\s-1URI\s0\fR に接続します。  省略すると、デフォルトの libvirt ハイパーバイザーに接続します。
.Sp
ゲストのブロックデバイスを直接指定していると（(\fI\-a\fR)）、libvirt は何も使用されません。
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
名前付きの libvirt 仮想マシンからすべてのディスクを追加します。  ドメインの \s-1UUID\s0 が名前の代わりに使用されます。
.IP "\fB\-\-echo\-keys\fR" 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-cat normally turns echoing off
so you cannot see what you are typing.  If you are not worried about Tempest
attacks and there is no one else in the room you can specify this flag to
see what you are typing.
.IP "\fB\-\-format=raw|qcow2|..\fR" 4
.IX Item "--format=raw|qcow2|.."
.PD 0
.IP "\fB\-\-format\fR" 4
.IX Item "--format"
.PD
\&\fI\-a\fR オプションのデフォルトはディスクイメージの形式を自動検知します。これを使用することにより、\fI\-a\fR
オプションのディスク形式をコマンドラインにおいて指定したものに強制できます。引数なしで \fI\-\-format\fR を使用することにより、後続の \fI\-a\fR
オプションに対して自動検知に戻せます。
.Sp
例:
.Sp
.Vb 1
\& virt\-cat \-\-format=raw \-a disk.img file
.Ve
.Sp
\&\f(CW\*(C`disk.img\*(C'\fR に対してローイメージを強制します（自動検出しません）。
.Sp
.Vb 1
\& virt\-cat \-\-format=raw \-a disk.img \-\-format \-a another.img file
.Ve
.Sp
\&\f(CW\*(C`disk.img\*(C'\fR に対してロー形式（自動検知なし）を強制し、\f(CW\*(C`another.img\*(C'\fR に対して自動検知に戻します。
.Sp
仮想マシンのディスクイメージが信頼できないロー形式であるならば、ディスク形式を指定するためにこのオプションを使用すべきです。これにより、悪意のある仮想マシンにより起こり得るセキュリティ問題を回避できます
(\s-1CVE\-2010\-3851\s0)。
.IP "\fB\-\-keys\-from\-stdin\fR" 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin.  The default is to try to read
passphrases from the user by opening \f(CW\*(C`/dev/tty\*(C'\fR.
.IP "\fB\-v\fR" 4
.IX Item "-v"
.PD 0
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
.PD
デバッグ用の冗長なメッセージを有効にします。
.IP "\fB\-V\fR" 4
.IX Item "-V"
.PD 0
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
バージョン番号を表示して終了します。
.IP "\fB\-x\fR" 4
.IX Item "-x"
libguestfs \s-1API\s0 呼び出しのトレースを有効にします。
.SH "旧形式のコマンドライン引数"
.IX Header "旧形式のコマンドライン引数"
以前のバージョンの virt-cat はどちらの書き込みもできます:
.PP
.Vb 1
\& virt\-cat disk.img [disk.img ...] file
.Ve
.PP
または
.PP
.Vb 1
\& virt\-cat guestname file
.Ve
.PP
whereas in this version you should use \fI\-a\fR or \fI\-d\fR respectively to avoid
the confusing case where a disk image might have the same name as a guest.
.PP
互換性のため古い形式がまだサポートされています。
.SH "Windows のパス"
.IX Header "Windows のパス"
\&\f(CW\*(C`virt\-cat\*(C'\fR は Windows のドライブレターとパスの解釈能力に制限があります（例: \f(CW\*(C`E:\efoo\ebar.txt\*(C'\fR）。
.PP
仮想マシンが Windows を実行している場合に限り:
.IP "\(bu" 4
Drive letter prefixes like \f(CW\*(C`C:\*(C'\fR are resolved against the Windows Registry
to the correct filesystem.
.IP "\(bu" 4
Any backslash (\f(CW\*(C`\e\*(C'\fR) characters in the path are replaced with forward
slashes so that libguestfs can process it.
.IP "\(bu" 4
The path is resolved case insensitively to locate the file that should be
displayed.
.PP
There are some known shortcomings:
.IP "\(bu" 4
Some \s-1NTFS\s0 symbolic links may not be followed correctly.
.IP "\(bu" 4
\&\s-1NTFS\s0 junction points that cross filesystems are not followed.
.SH "guestfish の使用法"
.IX Header "guestfish の使用法"
\&\fIguestfish\fR\|(1) は \f(CW\*(C`virt\-cat\*(C'\fR がうまく機能しないときに使用できる、より強力な、より低レベルなツールです。
.PP
\&\f(CW\*(C`virt\-cat\*(C'\fR を使用することは、次のこととほぼ同等です:
.PP
.Vb 1
\& guestfish \-\-ro \-i \-d domname download file \-
.Ve
.PP
ここで \f(CW\*(C`domname\*(C'\fR は libvirt 仮想マシンの名前です。また、\f(CW\*(C`file\*(C'\fR はファイルの完全パスです。最後の \f(CW\*(C`\-\*(C'\fR
(\*(L"標準出力に出力\*(R" を意味します) に注意してください。
.PP
上のコマンドは libguestfs の仮想マシン検査機能を使用します。そのため、libguestfs
が検査できない仮想マシンにおいて、または仮想マシンを含んでいない任意のディスクイメージのようなものにおいて、うまく動作しません。ディスクイメージから直接ファイルを表示するには、次を使用します:
.PP
.Vb 1
\& guestfish \-\-ro \-a disk.img \-m /dev/sda1 download file \-
.Ve
.PP
ここで、\f(CW\*(C`disk.img\*(C'\fR はディスクイメージ、\f(CW\*(C`/dev/sda1\*(C'\fR はディスクイメージにあるファイルシステム、そして \f(CW\*(C`file\*(C'\fR
はファイルの完全パスです。
.SH "SHELL QUOTING"
.IX Header "SHELL QUOTING"
Libvirt guest names can contain arbitrary characters, some of which have
meaning to the shell such as \f(CW\*(C`#\*(C'\fR and space.  You may need to quote or
escape these characters on the command line.  See the shell manual page
\&\fIsh\fR\|(1) for details.
.SH "終了ステータス"
.IX Header "終了ステータス"
このプログラムは、成功すると 0 を、エラーがあると 0 以外を返します。
.SH "関連項目"
.IX Header "関連項目"
\&\fIguestfs\fR\|(3), \fIguestfish\fR\|(1), \fIvirt\-copy\-out\fR\|(1), \fIvirt\-edit\fR\|(1),
\&\fIvirt\-tar\-out\fR\|(1), <http://libguestfs.org/>.
.SH "著者"
.IX Header "著者"
Richard W.M. Jones <http://people.redhat.com/~rjones/>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2010\-2012 Red Hat Inc.
.PP
This program is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
.PP
This program is distributed in the hope that it will be useful, but \s-1WITHOUT\s0
\&\s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or
\&\s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the \s-1GNU\s0 General Public License for
more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51
Franklin Street, Fifth Floor, Boston, \s-1MA\s0 02110\-1301 \s-1USA\s0.