inspect_list_applications


Description:

[ CCode ( array_length = false , array_null_terminated = true ) ]
[ Version ( deprecated = true , since = "1.7.8" ) ]
public Application[] inspect_list_applications (string root) throws Error

Warning: inspect_list_applications is deprecated.

get list of applications installed in the operating system

Note:

In new code, use inspect_list_applications2 instead

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:

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

app_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 app_name instead.

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

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

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

app_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 "".

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

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

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

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

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

app_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 Application objects, or NULL on error