libprelude Reference Manual | ||||
---|---|---|---|---|
Top | Description |
typedef prelude_gid_t; typedef prelude_uid_t; typedef prelude_client_profile_t; int prelude_client_profile_new (prelude_client_profile_t **ret, const char *name); prelude_client_profile_t * prelude_client_profile_ref (prelude_client_profile_t *cp); void prelude_client_profile_destroy (prelude_client_profile_t *cp); void prelude_client_profile_get_config_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_analyzerid_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_key_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_server_ca_cert_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_server_keycert_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_server_crl_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_client_keycert_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_tls_client_trusted_cert_filename (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_backup_dirname (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_profile_dirname (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_get_default_config_dirname (const prelude_client_profile_t *cp, char *buf, size_t size); int prelude_client_profile_set_prefix (prelude_client_profile_t *cp, const char *prefix); void prelude_client_profile_get_prefix (const prelude_client_profile_t *cp, char *buf, size_t size); void prelude_client_profile_set_uid (prelude_client_profile_t *cp, prelude_uid_t uid); prelude_uid_t prelude_client_profile_get_uid (const prelude_client_profile_t *cp); void prelude_client_profile_set_gid (prelude_client_profile_t *cp, prelude_uid_t gid); prelude_gid_t prelude_client_profile_get_gid (const prelude_client_profile_t *cp); int prelude_client_profile_set_name (prelude_client_profile_t *cp, const char *name); const char * prelude_client_profile_get_name (const prelude_client_profile_t *cp); uint64_t prelude_client_profile_get_analyzerid (const prelude_client_profile_t *cp); void prelude_client_profile_set_analyzerid (prelude_client_profile_t *cp, uint64_t analyzerid); int prelude_client_profile_get_credentials (prelude_client_profile_t *cp, void **credentials);
int prelude_client_profile_new (prelude_client_profile_t **ret, const char *name);
Creates a new prelude_client_profile_t object and store its
address into ret
.
|
Pointer where to store the address of the created object. |
|
Name for this profile. |
Returns : |
0 on success or a negative value if an error occured. |
prelude_client_profile_t * prelude_client_profile_ref (prelude_client_profile_t *cp);
|
|
Returns : |
void prelude_client_profile_destroy (prelude_client_profile_t *cp);
Destroys cp
.
|
Pointer to a prelude_client_profile_t. |
void prelude_client_profile_get_config_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store cp
configuration template.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_analyzerid_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store cp
unique and permanent analyzer ident.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_key_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store cp
private key.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_server_ca_cert_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store cp
related CA certificate.
This only apply to cp
receiving connection from analyzer (server).
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_server_keycert_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store certificate for cp
server.
This only apply to cp
receiving connection from analyzer (server).
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_server_crl_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store CRL for cp
server.
This only apply to cp
receiving connection from analyzer (server).
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_client_keycert_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store public certificate for cp
private key.
This only apply to client connecting to a peer.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_tls_client_trusted_cert_filename (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the filename used to store peers public certificates that cp
trust.
This only apply to client connecting to a peer.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_backup_dirname (const prelude_client_profile_t *cp, char *buf, size_t size);
Writes the directory name where the profile for cp
is stored. If
cp
is NULL or has no name, then this function will provide the main
profile directory.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_get_profile_dirname (const prelude_client_profile_t *cp, char *buf, size_t size);
|
|
|
|
|
void prelude_client_profile_get_default_config_dirname (const prelude_client_profile_t *cp, char *buf, size_t size);
|
|
|
|
|
int prelude_client_profile_set_prefix (prelude_client_profile_t *cp, const char *prefix);
This function allow to dynamically change the prefix used to acess libprelude related file. This is particularly usefull in case of application running under certain condition (chroot).
|
pointer on a prelude_client_profile_t object. |
|
Prefix to use for various libprelude files. |
Returns : |
0 on success, a negative value if an error occured. |
void prelude_client_profile_get_prefix (const prelude_client_profile_t *cp, char *buf, size_t size);
Retrieve current prefix used with this profile.
|
pointer on a prelude_client_profile_t object. |
|
buffer to write the returned filename to. |
|
size of buf .
|
void prelude_client_profile_set_uid (prelude_client_profile_t *cp, prelude_uid_t uid);
Sets the UID used by cp
to uid
.
|
Pointer to a prelude_client_profile_t object. |
|
UID to be used by cp .
|
prelude_uid_t prelude_client_profile_get_uid (const prelude_client_profile_t *cp);
Gets the UID associated with cp
.
|
Pointer to a prelude_client_profile_t object. |
Returns : |
the UID associated used by cp .
|
void prelude_client_profile_set_gid (prelude_client_profile_t *cp, prelude_uid_t gid);
Sets the GID used by cp
to gid
.
|
Pointer to a prelude_client_profile_t object. |
|
GID to be used by cp .
|
prelude_gid_t prelude_client_profile_get_gid (const prelude_client_profile_t *cp);
Gets the GID associated with cp
.
|
Pointer to a prelude_client_profile_t object. |
Returns : |
the GID associated used by cp .
|
int prelude_client_profile_set_name (prelude_client_profile_t *cp, const char *name);
Sets the prelude client profile name.
|
Pointer to a prelude_client_profile_t object. |
|
Name to associate the profile with. |
Returns : |
0 on success or a negative value if an error occured. |
const char * prelude_client_profile_get_name (const prelude_client_profile_t *cp);
Gets the name of cp
client profile.
|
Pointer to a prelude_client_profile_t object. |
Returns : |
the name used by cp .
|
uint64_t prelude_client_profile_get_analyzerid (const prelude_client_profile_t *cp);
Gets the unique and permanent analyzer ident associated with cp
.
|
Pointer to a prelude_client_profile_t object. |
Returns : |
the analyzer ident used by cp .
|
void prelude_client_profile_set_analyzerid (prelude_client_profile_t *cp, uint64_t analyzerid);
Sets the Analyzer ID used by cp
to analyzerid
.
|
Pointer to a prelude_client_profile_t object. |
|
Analyzer ID to be used by cp .
|