SpiceClientGLib.SmartcardManager

g GObject.Object GObject.Object SpiceClientGLib.SmartcardManager SpiceClientGLib.SmartcardManager GObject.Object->SpiceClientGLib.SmartcardManager

Subclasses:

None

Methods

Inherited:

GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class

get ()

get_readers ()

insert_card ()

remove_card ()

Virtual Methods

Inherited:

GObject.Object (7)

do_card_inserted (reader)

do_card_removed (reader)

do_reader_added (reader)

do_reader_removed (reader)

Properties

None

Signals

Inherited:

GObject.Object (1)

Name

Short Description

card-inserted

The SpiceClientGLib.SmartcardManager ::card-inserted signal is emitted whenever a smartcard is inserted in a reader

card-removed

The SpiceClientGLib.SmartcardManager ::card-removed signal is emitted whenever a smartcard was removed from a reader.

reader-added

The SpiceClientGLib.SmartcardManager ::reader-added signal is emitted whenever a new smartcard reader (software or hardware) has been plugged in.

reader-removed

The SpiceClientGLib.SmartcardManager ::reader-removed signal is emitted whenever a smartcard reader (software or hardware) has been removed.

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent

GObject.Object

r

Class Details

class SpiceClientGLib.SmartcardManager(**kwargs)
Bases:

GObject.Object

Abstract:

No

Structure:

SpiceClientGLib.SmartcardManagerClass

The SpiceClientGLib.SmartcardManager struct is opaque and should not be accessed directly.

classmethod get()
Returns:

a weak reference to the SpiceClientGLib.SmartcardManager

Return type:

SpiceClientGLib.SmartcardManager

SpiceClientGLib.SmartcardManager is a singleton, use this function to get a pointer to it. A new SpiceClientGLib.SmartcardManager instance will be created the first time this function is called

get_readers()
Returns:

a newly allocated list of SpiceClientGLib.SmartcardReader instances, or None if none were found. When no longer needed, the list must be freed after unreferencing its elements with GObject.boxed_free()

Return type:

[SpiceClientGLib.SmartcardReader]

Gets the list of smartcard readers that are currently available, they can be either software (emulated) readers, or hardware ones.

New in version 0.20.

insert_card()
Returns:

True if smartcard insertion was successfully simulated, False if this failed, or if software smartcard support isn’t enabled.

Return type:

bool

Simulates the insertion of a smartcard in the guest. Valid certificates must have been set in SpiceClientGLib.Session :smartcard-certificates for software smartcard support to work. At the moment, only one software smartcard reader is supported, that’s why there is no parameter to indicate which reader to insert the card in.

New in version 0.20.

remove_card()
Returns:

True if smartcard removal was successfully simulated, False if this failed, or if software smartcard support isn’t enabled.

Return type:

bool

Simulates the removal of a smartcard in the guest. At the moment, only one software smartcard reader is supported, that’s why there is no parameter to indicate which reader to insert the card in.

New in version 0.20.

do_card_inserted(reader) virtual
Parameters:

reader (SpiceClientGLib.SmartcardReader) –

do_card_removed(reader) virtual
Parameters:

reader (SpiceClientGLib.SmartcardReader) –

do_reader_added(reader) virtual
Parameters:

reader (SpiceClientGLib.SmartcardReader) –

do_reader_removed(reader) virtual
Parameters:

reader (SpiceClientGLib.SmartcardReader) –

Signal Details

SpiceClientGLib.SmartcardManager.signals.card_insertedcard_inserted(*fixme)
Signal Name:

card-inserted

Flags:

RUN_FIRST

(FIXME pgi-docgen: arguments are missing here)

The SpiceClientGLib.SmartcardManager ::card-inserted signal is emitted whenever a smartcard is inserted in a reader

SpiceClientGLib.SmartcardManager.signals.card_removedcard_removed(*fixme)
Signal Name:

card-removed

Flags:

RUN_FIRST

(FIXME pgi-docgen: arguments are missing here)

The SpiceClientGLib.SmartcardManager ::card-removed signal is emitted whenever a smartcard was removed from a reader.

SpiceClientGLib.SmartcardManager.signals.reader_addedreader_added(*fixme)
Signal Name:

reader-added

Flags:

RUN_FIRST

(FIXME pgi-docgen: arguments are missing here)

The SpiceClientGLib.SmartcardManager ::reader-added signal is emitted whenever a new smartcard reader (software or hardware) has been plugged in.

SpiceClientGLib.SmartcardManager.signals.reader_removedreader_removed(*fixme)
Signal Name:

reader-removed

Flags:

RUN_FIRST

(FIXME pgi-docgen: arguments are missing here)

The SpiceClientGLib.SmartcardManager ::reader-removed signal is emitted whenever a smartcard reader (software or hardware) has been removed.