Callbacks¶
Rtrlib provides 3 callbacks one for updates on the manager status, one for pfx_table and one for spki_table updates.
RTR Manager Status Callback¶
This callback is called when the RTR Managers status is changed. The callback function must take 4 arguments.
-
manager_status_callback
(rtr_mgr_group, group_status, rtr_socket, data)¶ Parameters:
This callback is registered at manager initialization using status_callback parameter. The data object may be passed with the status_callback_data parameter.
PFX iteration callback¶
This callback can be used to iterate over the entire pfx table.
-
pfx_for_each
(pfx_record, data)¶ pfx_record is only guaranteed to be valid during this function call. If you want to store it somewhere e.g. in data than you have to copy it. you can use
rtrlib.records.copy_pfx_record()
for this.Parameters:
PFX update callback¶
This callback is called for any change to the Prefix validation table, it takes two arguments.
-
pfx_update_callback(pfx_record, added):
Parameters: - pfx_record (
rtrlib.records.PFXRecord
) – The affected pfx record - added (
bool
) – Indicates whether the record was added or removed - data – Data Object, if defined at manager initialization
- pfx_record (
This callback is registered at manager initialization using the pfx_update_callback parameter. The data object may be passed with the pfx_update_callback_data parameter.
SPKI update callback¶
This callback is called for any change to the Subject Public Key Info table, it takes two arguments.
Warning
This callback is untested due to the lack of spki support in rtr cache server implementations.
-
spki_update_callback(spki_record, added):
Parameters: - spki_record (
rtrlib.records.SPKIRecord
) – The affected spki record - added (
bool
) – Indicates whether the record was added or removed - data – Data Object, if defined at manager initialization
- spki_record (
This callback is registered at manager initialization using the spki_update_callback parameter. The data object may be passed with the spki_update_callback_data parameter.