ListallerIPKSecurityInfo

ListallerIPKSecurityInfo — Package security information

Functions

Properties

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

Types and Values

Object Hierarchy

    GEnum
    ├── ListallerSecurityLevel
    ├── ListallerSignStatus
    ╰── ListallerSignTrust
    GObject
    ╰── ListallerIPKSecurityInfo

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.

Functions

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);

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

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.

Parameters

self

the ListallerIPKSecurityInfo instance to query

 

Returns

the value of the "trust-reason" property


listaller_security_level_to_string ()

gchar *
listaller_security_level_to_string (ListallerSecurityLevel self);

Parameters

self

the ListallerSecurityLevel instance

 

listaller_security_level_from_string ()

ListallerSecurityLevel
listaller_security_level_from_string (const gchar *str);

Parameters

str

 

 

listaller_sign_status_to_string ()

gchar *
listaller_sign_status_to_string (ListallerSignStatus self);

Parameters

self

the ListallerSignStatus instance

 

listaller_sign_trust_to_string ()

gchar *
listaller_sign_trust_to_string (ListallerSignTrust self);

Parameters

self

the ListallerSignTrust instance

 

Types and Values

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.

Members

GObjectClass parent_class;

the parent class structure

 

enum ListallerSecurityLevel

Simple indicator of package security

Members

LISTALLER_SECURITY_LEVEL_DANGEROUS

   

LISTALLER_SECURITY_LEVEL_LOW

   

LISTALLER_SECURITY_LEVEL_MEDIUM

   

LISTALLER_SECURITY_LEVEL_HIGH

   

enum ListallerSignStatus

Status of a package signature

Members

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

   

enum ListallerSignTrust

Trust level of a signature

Members

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

   

Property Details

The “key-fpr” property

  “key-fpr”                  gchar *

key-fpr.

Flags: Read / Write

Default value: NULL


The “signature-status” property

  “signature-status”         ListallerSignStatus

signature-status.

Flags: Read / Write

Default value: LISTALLER_SIGN_STATUS_UNKNOWN


The “signature-trustlevel” property

  “signature-trustlevel”     ListallerSignTrust

signature-trustlevel.

Flags: Read / Write

Default value: LISTALLER_SIGN_TRUST_UNKNOWN


The “trust-reason” property

  “trust-reason”             gchar *

trust-reason.

Flags: Read / Write

Default value: NULL


The “user-names” property

  “user-names”               gchar *

user-names.

Flags: Read / Write

Default value: NULL