fish/rc_protocol.c
fish/rc_protocol.h
fish/stamp-guestfish.pod
+fish/stamp-virt-copy-in.pod
+fish/stamp-virt-copy-out.pod
+fish/stamp-virt-tar-in.pod
+fish/stamp-virt-tar-out.pod
+fish/virt-copy-in.1
+fish/virt-copy-out.1
+fish/virt-tar-in.1
+fish/virt-tar-out.1
fuse/guestmount
fuse/guestmount.1
fuse/stamp-guestmount.pod
html/guestmount.1.html
html/recipes.html
html/virt-cat.1.html
+html/virt-copy-in.1.html
+html/virt-copy-out.1.html
html/virt-df.1.html
html/virt-edit.1.html
html/virt-filesystems.1.html
html/virt-rescue.1.html
html/virt-resize.1.html
html/virt-tar.1.html
+html/virt-tar-in.1.html
+html/virt-tar-out.1.html
html/virt-win-reg.1.html
images/100kallnewlines
images/100kallspaces
html/guestfish.1.html \
html/guestmount.1.html \
html/virt-cat.1.html \
+ html/virt-copy-in.1.html \
+ html/virt-copy-out.1.html \
html/virt-df.1.html \
html/virt-edit.1.html \
html/virt-filesystems.1.html \
html/virt-rescue.1.html \
html/virt-resize.1.html \
html/virt-tar.1.html \
+ html/virt-tar-in.1.html \
+ html/virt-tar-out.1.html \
html/virt-win-reg.1.html \
html/recipes.html \
html/pod.css html/recipes.css
L<guestfs(3)>,
L<guestfish(1)>,
+L<virt-copy-out(1)>,
L<virt-edit(1)>,
+L<virt-tar-out(1)>,
L<http://libguestfs.org/>.
=head1 AUTHOR
$(BUILT_SOURCES) \
rc_protocol.x \
guestfish.pod \
- guestfish-bash-completion.sh
+ guestfish-bash-completion.sh \
+ virt-copy-in \
+ virt-copy-out \
+ virt-tar-in \
+ virt-tar-out \
+ virt-copy-in.pod \
+ virt-copy-out.pod \
+ virt-tar-in.pod \
+ virt-tar-out.pod
# These source files (all related to option parsing) are shared
# between guestfish and guestmount. Keep a convenient list here just
mv $@-t $@
endif
-# Manual page.
+# Script wrappers.
-man_MANS = guestfish.1
-noinst_DATA = $(top_builddir)/html/guestfish.1.html
+bin_SCRIPTS = virt-copy-in virt-copy-out virt-tar-in virt-tar-out
+
+# Manual pages.
+
+man_MANS = \
+ guestfish.1 \
+ virt-copy-in.1 \
+ virt-copy-out.1 \
+ virt-tar-in.1 \
+ virt-tar-out.1
+noinst_DATA = \
+ $(top_builddir)/html/guestfish.1.html \
+ $(top_builddir)/html/virt-copy-in.1.html \
+ $(top_builddir)/html/virt-copy-out.1.html \
+ $(top_builddir)/html/virt-tar-in.1.html \
+ $(top_builddir)/html/virt-tar-out.1.html
guestfish.1 $(top_builddir)/html/guestfish.1.html: stamp-guestfish.pod
$<
touch $@
+virt-copy-in.1 $(top_builddir)/html/virt-copy-in.1.html: stamp-virt-copy-in.pod
+
+stamp-virt-copy-in.pod: virt-copy-in.pod
+ $(top_srcdir)/podwrapper.sh \
+ --man virt-copy-in.1 \
+ --html $(top_builddir)/html/virt-copy-in.1.html \
+ $<
+ touch $@
+
+virt-copy-out.1 $(top_builddir)/html/virt-copy-out.1.html: stamp-virt-copy-out.pod
+
+stamp-virt-copy-out.pod: virt-copy-out.pod
+ $(top_srcdir)/podwrapper.sh \
+ --man virt-copy-out.1 \
+ --html $(top_builddir)/html/virt-copy-out.1.html \
+ $<
+ touch $@
+
+virt-tar-in.1 $(top_builddir)/html/virt-tar-in.1.html: stamp-virt-tar-in.pod
+
+stamp-virt-tar-in.pod: virt-tar-in.pod
+ $(top_srcdir)/podwrapper.sh \
+ --man virt-tar-in.1 \
+ --html $(top_builddir)/html/virt-tar-in.1.html \
+ $<
+ touch $@
+
+virt-tar-out.1 $(top_builddir)/html/virt-tar-out.1.html: stamp-virt-tar-out.pod
+
+stamp-virt-tar-out.pod: virt-tar-out.pod
+ $(top_srcdir)/podwrapper.sh \
+ --man virt-tar-out.1 \
+ --html $(top_builddir)/html/virt-tar-out.1.html \
+ $<
+ touch $@
+
# Bash completion script.
bashcompletiondir = $(sysconfdir)/bash_completion.d
L<guestfs(3)>,
L<http://libguestfs.org/>,
L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-copy-out(1)>,
L<virt-df(1)>,
L<virt-edit(1)>,
L<virt-filesystems(1)>,
L<virt-rescue(1)>,
L<virt-resize(1)>,
L<virt-tar(1)>,
+L<virt-tar-in(1)>,
+L<virt-tar-out(1)>,
L<virt-win-reg(1)>,
L<hexedit(1)>.
--- /dev/null
+#!/bin/bash -
+# virt-copy-in
+# Copyright (C) 2011 Red Hat Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+exec guestfish --rw -i copy-in "$@"
--- /dev/null
+=encoding utf8
+
+=head1 NAME
+
+virt-copy-in - Copy files and directories into a virtual machine disk image.
+
+=head1 SYNOPSIS
+
+ virt-copy-in -a disk.img file|dir [file|dir ...] /destination
+
+ virt-copy-in -d domain file|dir [file|dir ...] /destination
+
+=head1 WARNING
+
+Using C<virt-copy-in> on live virtual machines can be dangerous,
+potentially causing disk corruption. The virtual machine must be
+shut down before you use this command.
+
+=head1 DESCRIPTION
+
+C<virt-copy-in> copies files and directories from the local disk into
+a virtual machine disk image or named libvirt domain.
+
+You can give one of more filenames and directories on the command
+line. Directories are copied in recursively. The final parameter
+must be the destination directory in the disk image which must be an
+absolute path starting with a C</> character.
+
+=head1 EXAMPLES
+
+Update C</etc/resolv.conf> in a guest:
+
+ virt-copy-in -d MyGuest resolv.conf /etc
+
+Upload a home directory to a guest:
+
+ virt-copy-in -d MyGuest skel /home
+
+=head1 JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH
+
+This command is just a simple shell script wrapper around the
+L<guestfish(1)> C<copy-in> command. For anything more complex than a
+trivial copy, you are probably better off using guestfish directly.
+
+=head1 OPTIONS
+
+Since the shell script just passes options straight to guestfish, read
+L<guestfish(1)> to see the full list of options.
+
+=head1 SEE ALSO
+
+L<guestfish(1)>,
+L<virt-cat(1)>,
+L<virt-copy-out(1)>,
+L<virt-edit(1)>,
+L<virt-tar-in(1)>,
+L<virt-tar-out(1)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc.
+L<http://libguestfs.org/>
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
--- /dev/null
+#!/bin/bash -
+# virt-copy-out
+# Copyright (C) 2011 Red Hat Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+exec guestfish --ro -i copy-out "$@"
--- /dev/null
+=encoding utf8
+
+=head1 NAME
+
+virt-copy-out - Copy files and directories out of a virtual machine disk image.
+
+=head1 SYNOPSIS
+
+ virt-copy-out -a disk.img /file|dir [/file|dir ...] localdir
+
+ virt-copy-out -d domain /file|dir [/file|dir ...] localdir
+
+=head1 DESCRIPTION
+
+C<virt-copy-out> copies files and directories out of a virtual machine
+disk image or named libvirt domain.
+
+You can give one of more filenames and directories on the command
+line. Directories are copied out recursively.
+
+=head1 EXAMPLES
+
+Download the home directories from a virtual machine:
+
+ mkdir homes
+ virt-copy-out -d MyGuest /home homes
+
+=head1 JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH
+
+This command is just a simple shell script wrapper around the
+L<guestfish(1)> C<copy-out> command. For anything more complex than a
+trivial copy, you are probably better off using guestfish directly.
+
+=head1 OPTIONS
+
+Since the shell script just passes options straight to guestfish, read
+L<guestfish(1)> to see the full list of options.
+
+=head1 SEE ALSO
+
+L<guestfish(1)>,
+L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-edit(1)>,
+L<virt-tar-in(1)>,
+L<virt-tar-out(1)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc.
+L<http://libguestfs.org/>
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
--- /dev/null
+#!/bin/bash -
+# virt-tar-in
+# Copyright (C) 2011 Red Hat Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+exec guestfish --rw -i tar-in "$@"
--- /dev/null
+=encoding utf8
+
+=head1 NAME
+
+virt-tar-in - Unpack a tarball into a virtual machine disk image.
+
+=head1 SYNOPSIS
+
+ virt-tar-in -a disk.img data.tar /destination
+
+ virt-tar-in -d domain data.tar /destination
+
+ zcat data.tar.gz | virt-tar-in -d domain - /destination
+
+=head1 WARNING
+
+Using C<virt-tar-in> on live virtual machines can be dangerous,
+potentially causing disk corruption. The virtual machine must be shut
+down before you use this command.
+
+=head1 DESCRIPTION
+
+C<virt-tar-in> unpacks an uncompressed tarball into a virtual machine
+disk image or named libvirt domain.
+
+The first parameter is the tar file. Use C<-> to read the tar file
+from standard input. The second parameter is the absolute target
+directory to unpack into.
+
+=head1 EXAMPLES
+
+Upload a home directory to a guest:
+
+ virt-tar-in -d MyGuest homes.tar /home
+
+=head1 JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH
+
+This command is just a simple shell script wrapper around the
+L<guestfish(1)> C<tar-in> command. For anything more complex than a
+trivial copy, you are probably better off using guestfish directly.
+
+=head1 OPTIONS
+
+Since the shell script just passes options straight to guestfish, read
+L<guestfish(1)> to see the full list of options.
+
+=head1 SEE ALSO
+
+L<guestfish(1)>,
+L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-copy-out(1)>,
+L<virt-edit(1)>,
+L<virt-make-fs(1)>,
+L<virt-tar-out(1)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc.
+L<http://libguestfs.org/>
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
--- /dev/null
+#!/bin/bash -
+# virt-tar-out
+# Copyright (C) 2011 Red Hat Inc.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+exec guestfish --ro -i tar-out "$@"
--- /dev/null
+=encoding utf8
+
+=head1 NAME
+
+virt-tar-out - Pack a virtual machine disk image directory into a tarball.
+
+=head1 SYNOPSIS
+
+ virt-tar-out -a disk.img /dir files.tar
+
+ virt-tar-out -d domain /dir files.tar
+
+ virt-tar-out -d domain /dir - | gzip --best > files.tar.gz
+
+=head1 DESCRIPTION
+
+C<virt-tar-out> packs a virtual machine disk image directory into a
+tarball.
+
+The first parameter is the absolute path of the virtual machine
+directory. The second parameter is the tar file to write. Use C<->
+to write to standard output.
+
+=head1 EXAMPLES
+
+Download the home directories from a guest:
+
+ virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz
+
+=head1 JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH
+
+This command is just a simple shell script wrapper around the
+L<guestfish(1)> C<tar-out> command. For anything more complex than a
+trivial copy, you are probably better off using guestfish directly.
+
+=head1 OPTIONS
+
+Since the shell script just passes options straight to guestfish, read
+L<guestfish(1)> to see the full list of options.
+
+=head1 SEE ALSO
+
+L<guestfish(1)>,
+L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-copy-out(1)>,
+L<virt-edit(1)>,
+L<virt-tar-in(1)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc.
+L<http://libguestfs.org/>
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
=item C<fish>
-L<guestfish(1)>, the command-line shell.
+L<guestfish(1)>, the command-line shell, and various shell scripts
+built on top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>,
+L<virt-tar-in(1)>, L<virt-tar-out(1)>.
=item C<fuse>
L<guestfish(1)>,
L<guestmount(1)>,
L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-copy-out(1)>,
L<virt-df(1)>,
L<virt-edit(1)>,
L<virt-filesystems(1)>,
L<virt-make-fs(1)>,
L<virt-rescue(1)>,
L<virt-tar(1)>,
+L<virt-tar-in(1)>,
+L<virt-tar-out(1)>,
L<virt-win-reg(1)>,
L<qemu(1)>,
L<febootstrap(1)>,
L<guestfs(3)>,
L<guestfish(1)>,
L<virt-cat(1)>,
+L<virt-copy-in(1)>,
+L<virt-tar-in(1)>,
L<Sys::Guestfs(3)>,
L<Sys::Guestfs::Lib(3)>,
L<Sys::Virt(3)>,
L<guestfish(1)>,
L<virt-resize(1)>,
-L<virt-tar(1)>,
+L<virt-tar-in(1)>,
L<mkisofs(1)>,
L<genisoimage(1)>,
L<mksquashfs(1)>,
virt-tar [--options] disk.img [disk.img ...] -u tarball directory
+=head1 NOTE
+
+This tool is obsolete. Use L<virt-copy-in(1)>, L<virt-copy-out(1)>,
+L<virt-tar-in(1)>, L<virt-tar-out(1)> as replacements.
+
=head1 EXAMPLES
Download C</home> from the VM into a local tarball:
L<guestfish(1)>,
L<virt-cat(1)>,
L<virt-edit(1)>,
+L<virt-copy-in(1)>,
+L<virt-copy-out(1)>,
+L<virt-tar-in(1)>,
+L<virt-tar-out(1)>,
L<Sys::Guestfs(3)>,
L<Sys::Guestfs::Lib(3)>,
L<Sys::Virt(3)>,
git.annexia.org / libguestfs.git / commitdiff