![]() |
![]() |
![]() |
Prelude library 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 .
|
int prelude_client_profile_get_credentials (prelude_client_profile_t *cp
,void **credentials
);
|
|
|
|
Returns : |