inspect_list_applications2

get list of applications installed in the operating system

Return the list of applications installed in the operating system.

*Note:* This call works differently from other parts of the inspection API. You have to call inspect_os, then inspect_get_mountpoints, then mount up the disks, before calling this. Listing applications is a significantly more difficult operation which requires access to the full filesystem. Also note that unlike the other "guestfs_inspect_get_*" calls which are just returning data cached in the libguestfs handle, this call actually reads parts of the mounted filesystems during the call.

This returns an empty list if the inspection code was not able to determine the list of applications.

The application structure contains the following fields:

app2_name The name of the application. For Red Hat-derived and Debian-derived Linux guests, this is the package name.

app2_display_name The display name of the application, sometimes localized to the install language of the guest operating system.

If unavailable this is returned as an empty string "". Callers needing to display something can use app2_name instead.

app2_epoch For package managers which use epochs, this contains the epoch of the package (an integer). If unavailable, this is returned as @0.

app2_version The version string of the application or package. If unavailable this is returned as an empty string "".

app2_release The release string of the application or package, for package managers that use this. If unavailable this is returned as an empty string "".

app2_arch The architecture string of the application or package, for package managers that use this. If unavailable this is returned as an empty string "".

app2_install_path The installation path of the application (on operating systems such as Windows which use installation paths). This path is in the format used by the guest operating system, it is not a libguestfs path.

If unavailable this is returned as an empty string "".

app2_trans_path The install path translated into a libguestfs path. If unavailable this is returned as an empty string "".

app2_publisher The name of the publisher of the application, for package managers that use this. If unavailable this is returned as an empty string "".

app2_url The URL (eg. upstream URL) of the application. If unavailable this is returned as an empty string "".

app2_source_package For packaging systems which support this, the name of the source package. If unavailable this is returned as an empty string "".

app2_summary A short (usually one line) description of the application or package. If unavailable this is returned as an empty string "".

app2_description A longer description of the application or package. If unavailable this is returned as an empty string "".

Please read "INSPECTION" in guestfs(3) for more details.

Parameters:

this	A GuestfsSession object

Returns:

an array of Application2 objects, or NULL on error