+" int\n"
+" guestfs_swapon_uuid (guestfs_h *g,\n"
+" const char *uuid);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6527
+msgid ""
+"This command enables swap to a swap partition with the given UUID. See "
+"C<guestfs_swapon_device> for other notes."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6534
+msgid "guestfs_sync"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6536
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_sync (guestfs_h *g);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6539 ../fish/guestfish-actions.pod:4409
+msgid ""
+"This syncs the disk, so that any writes are flushed through to the "
+"underlying disk image."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6542 ../fish/guestfish-actions.pod:4412
+msgid ""
+"You should always call this if you have modified a disk image, before "
+"closing the handle."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6549
+msgid "guestfs_tail"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6551
+#, no-wrap
+msgid ""
+" char **\n"
+" guestfs_tail (guestfs_h *g,\n"
+" const char *path);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6555 ../fish/guestfish-actions.pod:4419
+msgid "This command returns up to the last 10 lines of a file as a list of strings."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6567
+msgid "guestfs_tail_n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6569
+#, no-wrap
+msgid ""
+" char **\n"
+" guestfs_tail_n (guestfs_h *g,\n"
+" int nrlines,\n"
+" const char *path);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6574 ../fish/guestfish-actions.pod:4429
+msgid ""
+"If the parameter C<nrlines> is a positive number, this returns the last "
+"C<nrlines> lines of the file C<path>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6577 ../fish/guestfish-actions.pod:4432
+msgid ""
+"If the parameter C<nrlines> is a negative number, this returns lines from "
+"the file C<path>, starting with the C<-nrlines>th line."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6591
+msgid "guestfs_tar_in"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6593
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_tar_in (guestfs_h *g,\n"
+" const char *tarfile,\n"
+" const char *directory);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6598 ../fish/guestfish-actions.pod:4444
+msgid ""
+"This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
+"tar file) into C<directory>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6601
+msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6606 ../src/guestfs-actions.pod:6623 ../src/guestfs-actions.pod:6639 ../src/guestfs-actions.pod:6655
+msgid "(Added in 1.0.3)"
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6608
+msgid "guestfs_tar_out"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6610
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_tar_out (guestfs_h *g,\n"
+" const char *directory,\n"
+" const char *tarfile);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6615 ../fish/guestfish-actions.pod:4456
+msgid ""
+"This command packs the contents of C<directory> and downloads it to local "
+"file C<tarfile>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6618
+msgid ""
+"To download a compressed tarball, use C<guestfs_tgz_out> or "
+"C<guestfs_txz_out>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6625
+msgid "guestfs_tgz_in"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6627
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_tgz_in (guestfs_h *g,\n"
+" const char *tarball,\n"
+" const char *directory);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6632 ../fish/guestfish-actions.pod:4468
+msgid ""
+"This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
+"tar file) into C<directory>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6635
+msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6641
+msgid "guestfs_tgz_out"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6643
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_tgz_out (guestfs_h *g,\n"
+" const char *directory,\n"
+" const char *tarball);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6648 ../fish/guestfish-actions.pod:4479
+msgid ""
+"This command packs the contents of C<directory> and downloads it to local "
+"file C<tarball>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6651
+msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6657
+msgid "guestfs_touch"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6659
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_touch (guestfs_h *g,\n"
+" const char *path);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6663 ../fish/guestfish-actions.pod:4490
+msgid ""
+"Touch acts like the L<touch(1)> command. It can be used to update the "
+"timestamps on a file, or, if the file does not exist, to create a new "
+"zero-length file."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6667 ../fish/guestfish-actions.pod:4494
+msgid ""
+"This command only works on regular files, and will fail on other file types "
+"such as directories, symbolic links, block special etc."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6674
+msgid "guestfs_truncate"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6676
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_truncate (guestfs_h *g,\n"
+" const char *path);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6680 ../fish/guestfish-actions.pod:4501
+msgid ""
+"This command truncates C<path> to a zero-length file. The file must exist "
+"already."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6687
+msgid "guestfs_truncate_size"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6689
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_truncate_size (guestfs_h *g,\n"
+" const char *path,\n"
+" int64_t size);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6694 ../fish/guestfish-actions.pod:4508
+msgid ""
+"This command truncates C<path> to size C<size> bytes. The file must exist "
+"already."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6697
+msgid ""
+"If the current file size is less than C<size> then the file is extended to "
+"the required size with zero bytes. This creates a sparse file (ie. disk "
+"blocks are not allocated for the file until you write to it). To create a "
+"non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6707
+msgid "guestfs_tune2fs_l"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6709
+#, no-wrap
+msgid ""
+" char **\n"
+" guestfs_tune2fs_l (guestfs_h *g,\n"
+" const char *device);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6713 ../fish/guestfish-actions.pod:4521
+msgid ""
+"This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
+"C<device>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6716 ../fish/guestfish-actions.pod:4524
+msgid ""
+"It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage "
+"for more details. The list of fields returned isn't clearly defined, and "
+"depends on both the version of C<tune2fs> that libguestfs was built against, "
+"and the filesystem itself."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6729
+msgid "guestfs_txz_in"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6731
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_txz_in (guestfs_h *g,\n"
+" const char *tarball,\n"
+" const char *directory);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6736 ../fish/guestfish-actions.pod:4533
+msgid ""
+"This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
+"tar file) into C<directory>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6743
+msgid "guestfs_txz_out"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6745
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_txz_out (guestfs_h *g,\n"
+" const char *directory,\n"
+" const char *tarball);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6750 ../fish/guestfish-actions.pod:4542
+msgid ""
+"This command packs the contents of C<directory> and downloads it to local "
+"file C<tarball> (as an xz compressed tar archive)."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6757
+msgid "guestfs_umask"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6759
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_umask (guestfs_h *g,\n"
+" int mask);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6763 ../fish/guestfish-actions.pod:4551
+msgid ""
+"This function sets the mask used for creating new files and device nodes to "
+"C<mask & 0777>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6766 ../fish/guestfish-actions.pod:4554
+msgid ""
+"Typical umask values would be C<022> which creates new files with "
+"permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
+"new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6771 ../fish/guestfish-actions.pod:4559
+msgid ""
+"The default umask is C<022>. This is important because it means that "
+"directories and device nodes will be created with C<0644> or C<0755> mode "
+"even if you specify C<0777>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6775
+msgid ""
+"See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
+"C<guestfs_mkdir>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6778 ../fish/guestfish-actions.pod:4566
+msgid "This call returns the previous umask."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6784
+msgid "guestfs_umount"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6786
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_umount (guestfs_h *g,\n"
+" const char *pathordevice);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6790 ../fish/guestfish-actions.pod:4574
+msgid ""
+"This unmounts the given filesystem. The filesystem may be specified either "
+"by its mountpoint (path) or the device which contains the filesystem."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6798
+msgid "guestfs_umount_all"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6800
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_umount_all (guestfs_h *g);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6803 ../fish/guestfish-actions.pod:4584
+msgid "This unmounts all mounted filesystems."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6805 ../fish/guestfish-actions.pod:4586
+msgid "Some internal mounts are not unmounted by this call."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6811
+msgid "guestfs_upload"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6813
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_upload (guestfs_h *g,\n"
+" const char *filename,\n"
+" const char *remotefilename);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6818 ../src/guestfs-actions.pod:6842 ../fish/guestfish-actions.pod:4592 ../fish/guestfish-actions.pod:4605
+msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6823
+msgid "See also C<guestfs_download>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6834
+msgid "guestfs_upload_offset"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6836
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_upload_offset (guestfs_h *g,\n"
+" const char *filename,\n"
+" const char *remotefilename,\n"
+" int64_t offset);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6845 ../fish/guestfish-actions.pod:4608
+msgid ""
+"C<remotefilename> is overwritten starting at the byte C<offset> specified. "
+"The intention is to overwrite parts of existing files or devices, although "
+"if a non-existant file is specified then it is created with a \"hole\" "
+"before C<offset>. The size of the data written is implicit in the size of "
+"the source C<filename>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6852
+msgid ""
+"Note that there is no limit on the amount of data that can be uploaded with "
+"this call, unlike with C<guestfs_pwrite>, and this call always writes the "
+"full amount unless an error occurs."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6857
+msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6868
+msgid "guestfs_utimens"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6870
+#, no-wrap
+msgid ""
+" int\n"
+" guestfs_utimens (guestfs_h *g,\n"
+" const char *path,\n"
+" int64_t atsecs,\n"
+" int64_t atnsecs,\n"
+" int64_t mtsecs,\n"
+" int64_t mtnsecs);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6878 ../fish/guestfish-actions.pod:4628
+msgid "This command sets the timestamps of a file with nanosecond precision."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6881 ../fish/guestfish-actions.pod:4631
+msgid ""
+"C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
+"from the epoch."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6884 ../fish/guestfish-actions.pod:4634
+msgid ""
+"C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
+"nanoseconds from the epoch."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6887 ../fish/guestfish-actions.pod:4637
+msgid ""
+"If the C<*nsecs> field contains the special value C<-1> then the "
+"corresponding timestamp is set to the current time. (The C<*secs> field is "
+"ignored in this case)."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6891 ../fish/guestfish-actions.pod:4641
+msgid ""
+"If the C<*nsecs> field contains the special value C<-2> then the "
+"corresponding timestamp is left unchanged. (The C<*secs> field is ignored "
+"in this case)."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6899 ../src/guestfs-structs.pod:175
+msgid "guestfs_version"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6901
+#, no-wrap
+msgid ""
+" struct guestfs_version *\n"
+" guestfs_version (guestfs_h *g);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6904 ../fish/guestfish-actions.pod:4649
+msgid "Return the libguestfs version number that the program is linked against."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6907 ../fish/guestfish-actions.pod:4652
+msgid ""
+"Note that because of dynamic linking this is not necessarily the version of "
+"libguestfs that you compiled against. You can compile the program, and then "
+"at runtime dynamically link against a completely different C<libguestfs.so> "
+"library."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6912 ../fish/guestfish-actions.pod:4657
+msgid ""
+"This call was added in version C<1.0.58>. In previous versions of "
+"libguestfs there was no way to get the version number. From C code you can "
+"use dynamic linker functions to find out if this symbol exists (if it "
+"doesn't, then it's an earlier version)."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4663
+msgid ""
+"The call returns a structure with four elements. The first three (C<major>, "
+"C<minor> and C<release>) are numbers and correspond to the usual version "
+"triplet. The fourth element (C<extra>) is a string and is normally empty, "
+"but may be used for distro-specific information."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6924 ../fish/guestfish-actions.pod:4669
+msgid "To construct the original version string: C<$major.$minor.$release$extra>"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6927 ../fish/guestfish-actions.pod:4672
+msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6929
+msgid ""
+"I<Note:> Don't use this call to test for availability of features. In "
+"enterprise distributions we backport features from later versions into "
+"earlier versions, making this an unreliable way to test for features. Use "
+"C<guestfs_available> instead."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6935
+msgid ""
+"This function returns a C<struct guestfs_version *>, or NULL if there was an "
+"error. I<The caller must call C<guestfs_free_version> after use>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6939
+msgid "(Added in 1.0.58)"
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:6941
+msgid "guestfs_vfs_label"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:6943
+#, no-wrap
+msgid ""
+" char *\n"
+" guestfs_vfs_label (guestfs_h *g,\n"
+" const char *device);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6947 ../fish/guestfish-actions.pod:4684
+msgid "This returns the filesystem label of the filesystem on C<device>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6950 ../fish/guestfish-actions.pod:4687
+msgid "If the filesystem is unlabeled, this returns the empty string."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:6952
+msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
git.annexia.org / libguestfs.git / blobdiff