diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2010-11-16 12:57:36 +0000 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2010-11-16 13:27:01 +0000 |
commit | fab75c0337d7897d10ea5e95e47ac05eab81ace9 (patch) | |
tree | a1fee811daabdcbc98489dcbb47c4b6265a1d12a /src/guestfs.pod | |
parent | 35afe0cb33c986bf595585a716ff259cf3415a1f (diff) | |
download | libguestfs-fab75c0337d7897d10ea5e95e47ac05eab81ace9.tar.gz libguestfs-fab75c0337d7897d10ea5e95e47ac05eab81ace9.tar.xz libguestfs-fab75c0337d7897d10ea5e95e47ac05eab81ace9.zip |
New API: inspect-get-hostname to return the hostname of the guest.
This returns the hostname of the guest. Tested on RHEL, Fedora,
Debian 5, Ubuntu 10.10, FreeBSD 8, Windows 7.
Diffstat (limited to 'src/guestfs.pod')
-rw-r--r-- | src/guestfs.pod | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/src/guestfs.pod b/src/guestfs.pod index 83709827..fc58f4f1 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -1095,6 +1095,14 @@ data. Callers should be careful to escape these before printing them to a structured file (for example, use HTML escaping if creating a web page). +Guest configuration may be altered in unusual ways by the +administrator of the virtual machine, and may not reflect reality +(particularly for untrusted or actively malicious guests). For +example we parse the hostname from configuration files like +C</etc/sysconfig/network> that we find in the guest, but the guest +administrator can easily manipulate these files to provide the wrong +hostname. + The inspection API parses guest configuration using two external libraries: Augeas (Linux configuration) and hivex (Windows Registry). Both are designed to be robust in the face of malicious data, although |