SignonSecurityContext

SignonSecurityContext — Representation of a security context.

Synopsis

struct              SignonSecurityContext;
typedef             SignonSecurityContextList;
SignonSecurityContext * signon_security_context_new     ();
SignonSecurityContext * signon_security_context_new_from_values
                                                        (const gchar *system_context,
                                                         const gchar *application_context);
SignonSecurityContext * signon_security_context_copy    (const SignonSecurityContext *src_ctx);
void                signon_security_context_free        (SignonSecurityContext *ctx);
void                signon_security_context_set_system_context
                                                        (SignonSecurityContext *ctx,
                                                         const gchar *system_context);
const gchar *       signon_security_context_get_system_context
                                                        (const SignonSecurityContext *ctx);
void                signon_security_context_set_application_context
                                                        (SignonSecurityContext *ctx,
                                                         const gchar *application_context);
const gchar *       signon_security_context_get_application_context
                                                        (const SignonSecurityContext *ctx);
GVariant *          signon_security_context_build_variant
                                                        (const SignonSecurityContext *ctx);
SignonSecurityContext * signon_security_context_deconstruct_variant
                                                        (GVariant *variant);
GVariant *          signon_security_context_list_build_variant
                                                        (const SignonSecurityContextList *list);
SignonSecurityContextList * signon_security_context_list_deconstruct_variant
                                                        (GVariant *variant);
SignonSecurityContextList * signon_security_context_list_copy
                                                        (const SignonSecurityContextList *src_list);
void                signon_security_context_list_free   (SignonSecurityContextList *seclist);

Object Hierarchy

  GBoxed
   +----SignonSecurityContext

Description

The SignonSecurityContext represents a security context within system and also within application.

Details

struct SignonSecurityContext

struct SignonSecurityContext {
    gchar *sys_ctx;
    gchar *app_ctx;
};

Security context descriptor. Practically a string tuple.

gchar *sys_ctx;

system context, such as SMACK-label, MSSF token or just a binary path.

gchar *app_ctx;

application context, such as a script or a web page.

SignonSecurityContextList

typedef GList SignonSecurityContextList;

GList of SignonSecurityContext items.


signon_security_context_new ()

SignonSecurityContext * signon_security_context_new     ();

Allocates a new security context item.

Returns :

(transfer full) allocated SignonSecurityContext.

signon_security_context_new_from_values ()

SignonSecurityContext * signon_security_context_new_from_values
                                                        (const gchar *system_context,
                                                         const gchar *application_context);

Allocates and initializes a new security context item.

system_context :

system security context (such as SMACK/MSSF label/token).

application_context :

application security context (such as a script name).

Returns :

(transfer full) allocated SignonSecurityContext.

signon_security_context_copy ()

SignonSecurityContext * signon_security_context_copy    (const SignonSecurityContext *src_ctx);

Copy a security context item.

src_ctx :

source security context to copy.

Returns :

(transfer full) a copy of the SignonSecurityContext item.

signon_security_context_free ()

void                signon_security_context_free        (SignonSecurityContext *ctx);

Frees a security context item.

ctx :

SignonSecurityContext to be freed.

signon_security_context_set_system_context ()

void                signon_security_context_set_system_context
                                                        (SignonSecurityContext *ctx,
                                                         const gchar *system_context);

Sets the system context part (such as SMACK label or MSSF token) of the SignonSecurityContext.

ctx :

SignonSecurityContext item.

system_context :

system security context.

signon_security_context_get_system_context ()

const gchar *       signon_security_context_get_system_context
                                                        (const SignonSecurityContext *ctx);

Get the system context part (such as SMACK label or MSSF token) of the SignonSecurityContext.

ctx :

SignonSecurityContext item.

Returns :

(transfer none) system context.

signon_security_context_set_application_context ()

void                signon_security_context_set_application_context
                                                        (SignonSecurityContext *ctx,
                                                         const gchar *application_context);

Sets the application context part (such as a script name or a web page) of the SignonSecurityContext.

ctx :

SignonSecurityContext item.

application_context :

application security context.

signon_security_context_get_application_context ()

const gchar *       signon_security_context_get_application_context
                                                        (const SignonSecurityContext *ctx);

Get the application context part (such as script name or a web page) of the SignonSecurityContext.

ctx :

SignonSecurityContext item.

Returns :

(transfer none) application context.

signon_security_context_build_variant ()

GVariant *          signon_security_context_build_variant
                                                        (const SignonSecurityContext *ctx);

Build a GVariant of type "(ss)" from a SignonSecurityContext item.

ctx :

SignonSecurityContext item.

Returns :

(transfer full) GVariant construct of a SignonSecurityContext.

signon_security_context_deconstruct_variant ()

SignonSecurityContext * signon_security_context_deconstruct_variant
                                                        (GVariant *variant);

Builds a SignonSecurityContext item from a GVariant of type "(ss)".

variant :

GVariant item with a SignonSecurityContext construct.

Returns :

(transfer full) SignonSecurityContext item.

signon_security_context_list_build_variant ()

GVariant *          signon_security_context_list_build_variant
                                                        (const SignonSecurityContextList *list);

Builds a GVariant of type "a(ss)" from a GList of SignonSecurityContext items.

list :

SignonSecurityContextList item.

Returns :

(transfer full) GVariant construct of a SignonSecurityContextList.

signon_security_context_list_deconstruct_variant ()

SignonSecurityContextList * signon_security_context_list_deconstruct_variant
                                                        (GVariant *variant);

Builds a GList of SignonSecurityContext items from a GVariant of type "a(ss)".

variant :

GVariant item with a list of security context tuples.

Returns :

SignonSecurityContextList item. [transfer full]

signon_security_context_list_copy ()

SignonSecurityContextList * signon_security_context_list_copy
                                                        (const SignonSecurityContextList *src_list);

Copies a GList of SignonSecurityContext items.

src_list :

source SignonSecurityContextList.

Returns :

SignonSecurityContextList item. [transfer full]

signon_security_context_list_free ()

void                signon_security_context_list_free   (SignonSecurityContextList *seclist);

Frees all items and the GList of SignonSecurityContext.

seclist :

(transfer full) SignonSecurityContextList item.