ListallerIPKSecurityInfo

ListallerIPKSecurityInfo — Package security information

Synopsis

#define             LISTALLER_IPK_TYPE_SECURITY_INFO
ListallerSecurityLevel listaller_ipk_security_info_get_level
                                                        (ListallerIPKSecurityInfo *self);
gchar *             listaller_ipk_security_info_get_level_as_sentence
                                                        (ListallerIPKSecurityInfo *self);
gchar *             listaller_ipk_security_info_get_level_as_string
                                                        (ListallerIPKSecurityInfo *self);
ListallerSignStatus listaller_ipk_security_info_get_signature_status
                                                        (ListallerIPKSecurityInfo *self);
ListallerSignTrust  listaller_ipk_security_info_get_signature_trustlevel
                                                        (ListallerIPKSecurityInfo *self);
const gchar *       listaller_ipk_security_info_get_user_names
                                                        (ListallerIPKSecurityInfo *self);
const gchar *       listaller_ipk_security_info_get_key_fpr
                                                        (ListallerIPKSecurityInfo *self);
const gchar *       listaller_ipk_security_info_get_trust_reason
                                                        (ListallerIPKSecurityInfo *self);
struct              ListallerIPKSecurityInfo;
struct              ListallerIPKSecurityInfoClass;
gchar *             listaller_security_level_to_string  (ListallerSecurityLevel self);
ListallerSecurityLevel listaller_security_level_from_string
                                                        (const gchar *str);
enum                ListallerSecurityLevel;
gchar *             listaller_sign_status_to_string     (ListallerSignStatus self);
enum                ListallerSignStatus;
gchar *             listaller_sign_trust_to_string      (ListallerSignTrust self);
enum                ListallerSignTrust;

Object Hierarchy

  GObject
   +----ListallerIPKSecurityInfo
  GEnum
   +----ListallerSecurityLevel
  GEnum
   +----ListallerSignStatus
  GEnum
   +----ListallerSignTrust

Properties

  "key-fpr"                  gchar*                : Read / Write
  "signature-status"         ListallerSignStatus   : Read / Write
  "signature-trustlevel"     ListallerSignTrust    : Read / Write
  "trust-reason"             gchar*                : Read / Write
  "user-names"               gchar*                : Read / Write

Description

This class stores data which can be used to display meaningful information about the security level of a 3rd-party software package. It provides information about the state of the package signature.

Details

LISTALLER_IPK_TYPE_SECURITY_INFO

#define LISTALLER_IPK_TYPE_SECURITY_INFO (listaller_ipk_security_info_get_type ())

The type for ListallerIPKSecurityInfo.


listaller_ipk_security_info_get_level ()

ListallerSecurityLevel listaller_ipk_security_info_get_level
                                                        (ListallerIPKSecurityInfo *self);

self :

the ListallerIPKSecurityInfo instance

Returns :

a human-readable general security level, which was determined for the associated package.

listaller_ipk_security_info_get_level_as_sentence ()

gchar *             listaller_ipk_security_info_get_level_as_sentence
                                                        (ListallerIPKSecurityInfo *self);

Get a sentence describing the security status of a package.

self :

the ListallerIPKSecurityInfo instance

listaller_ipk_security_info_get_level_as_string ()

gchar *             listaller_ipk_security_info_get_level_as_string
                                                        (ListallerIPKSecurityInfo *self);

Get a simple workd (such as "high" or "low") which describes the security status of a package.

self :

the ListallerIPKSecurityInfo instance

listaller_ipk_security_info_get_signature_status ()

ListallerSignStatus listaller_ipk_security_info_get_signature_status
                                                        (ListallerIPKSecurityInfo *self);

Get and return the current value of the "signature-status" property.

self :

the ListallerIPKSecurityInfo instance to query

Returns :

the value of the "signature-status" property

listaller_ipk_security_info_get_signature_trustlevel ()

ListallerSignTrust  listaller_ipk_security_info_get_signature_trustlevel
                                                        (ListallerIPKSecurityInfo *self);

Get and return the current value of the "signature-trustlevel" property.

self :

the ListallerIPKSecurityInfo instance to query

Returns :

the value of the "signature-trustlevel" property

listaller_ipk_security_info_get_user_names ()

const gchar *       listaller_ipk_security_info_get_user_names
                                                        (ListallerIPKSecurityInfo *self);

Get and return the current value of the "user-names" property.

self :

the ListallerIPKSecurityInfo instance to query

Returns :

the value of the "user-names" property

listaller_ipk_security_info_get_key_fpr ()

const gchar *       listaller_ipk_security_info_get_key_fpr
                                                        (ListallerIPKSecurityInfo *self);

Get and return the current value of the "key-fpr" property.

self :

the ListallerIPKSecurityInfo instance to query

Returns :

the value of the "key-fpr" property

listaller_ipk_security_info_get_trust_reason ()

const gchar *       listaller_ipk_security_info_get_trust_reason
                                                        (ListallerIPKSecurityInfo *self);

Get and return the current value of the "trust-reason" property.

self :

the ListallerIPKSecurityInfo instance to query

Returns :

the value of the "trust-reason" property

struct ListallerIPKSecurityInfo

struct ListallerIPKSecurityInfo;

Package security information

This class stores data which can be used to display meaningful information about the security level of a 3rd-party software package. It provides information about the state of the package signature.


struct ListallerIPKSecurityInfoClass

struct ListallerIPKSecurityInfoClass {
	GObjectClass parent_class;
};

The class structure for LISTALLER_IPK_TYPE_SECURITY_INFO. All the fields in this structure are private and should never be accessed directly.

GObjectClass parent_class;

the parent class structure

listaller_security_level_to_string ()

gchar *             listaller_security_level_to_string  (ListallerSecurityLevel self);

self :

the ListallerSecurityLevel instance

listaller_security_level_from_string ()

ListallerSecurityLevel listaller_security_level_from_string
                                                        (const gchar *str);

str :

 

enum ListallerSecurityLevel

typedef enum {
	LISTALLER_SECURITY_LEVEL_DANGEROUS,
	LISTALLER_SECURITY_LEVEL_LOW,
	LISTALLER_SECURITY_LEVEL_MEDIUM,
	LISTALLER_SECURITY_LEVEL_HIGH
} ListallerSecurityLevel;

Simple indicator of package security


listaller_sign_status_to_string ()

gchar *             listaller_sign_status_to_string     (ListallerSignStatus self);

self :

the ListallerSignStatus instance

enum ListallerSignStatus

typedef enum {
	LISTALLER_SIGN_STATUS_UNKNOWN,
	LISTALLER_SIGN_STATUS_VALID,
	LISTALLER_SIGN_STATUS_KEY_EXPIRED,
	LISTALLER_SIGN_STATUS_KEY_MISSING,
	LISTALLER_SIGN_STATUS_CERT_REVOKED,
	LISTALLER_SIGN_STATUS_SIG_EXPIRED,
	LISTALLER_SIGN_STATUS_BAD,
	LISTALLER_SIGN_STATUS_NO_PUBKEY
} ListallerSignStatus;

Status of a package signature


listaller_sign_trust_to_string ()

gchar *             listaller_sign_trust_to_string      (ListallerSignTrust self);

self :

the ListallerSignTrust instance

enum ListallerSignTrust

typedef enum {
	LISTALLER_SIGN_TRUST_UNKNOWN,
	LISTALLER_SIGN_TRUST_BAD_VALUE,
	LISTALLER_SIGN_TRUST_UNDEFINED,
	LISTALLER_SIGN_TRUST_NEVER,
	LISTALLER_SIGN_TRUST_MARGINAL,
	LISTALLER_SIGN_TRUST_FULL,
	LISTALLER_SIGN_TRUST_ULTIMATE
} ListallerSignTrust;

Trust level of a signature

Property Details

The "key-fpr" property

  "key-fpr"                  gchar*                : Read / Write

key-fpr.

Default value: NULL


The "signature-status" property

  "signature-status"         ListallerSignStatus   : Read / Write

signature-status.

Default value: LISTALLER_SIGN_STATUS_UNKNOWN


The "signature-trustlevel" property

  "signature-trustlevel"     ListallerSignTrust    : Read / Write

signature-trustlevel.

Default value: LISTALLER_SIGN_TRUST_UNKNOWN


The "trust-reason" property

  "trust-reason"             gchar*                : Read / Write

trust-reason.

Default value: NULL


The "user-names" property

  "user-names"               gchar*                : Read / Write

user-names.

Default value: NULL