| Prelude library Reference Manual | ||||
|---|---|---|---|---|
typedef prelude_client_profile_t; int prelude_client_profile_new (prelude_client_profile_t **ret, const char *name); 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_set_uid (prelude_client_profile_t *cp, uid_t uid); uid_t prelude_client_profile_get_uid (const prelude_client_profile_t *cp); void prelude_client_profile_set_gid (prelude_client_profile_t *cp, uid_t gid); 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.
| ret : | Pointer where to store the address of the created object. |
| name : | Name for this profile. |
| Returns : | 0 on success or a negative value if an error occured. |
void prelude_client_profile_destroy (prelude_client_profile_t *cp);
Destroys cp.
| 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.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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).
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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).
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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).
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | 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 client is stored.
| cp : | pointer on a prelude_client_profile_t object. |
| buf : | buffer to write the returned filename to. |
| size : | size of buf. |
void prelude_client_profile_get_profile_dirname
(const prelude_client_profile_t *cp,
char *buf,
size_t size);
| cp : | |
| buf : | |
| size : |
void prelude_client_profile_set_uid (prelude_client_profile_t *cp, uid_t uid);
Sets the UID used by cp to uid.
| cp : | Pointer to a prelude_client_profile_t object. |
| uid : | UID to be used by cp. |
uid_t prelude_client_profile_get_uid (const prelude_client_profile_t *cp);
Gets the UID associated with cp.
| 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, uid_t gid);
Sets the GID used by cp to gid.
| cp : | Pointer to a prelude_client_profile_t object. |
| gid : | GID to be used by cp. |
gid_t prelude_client_profile_get_gid (const prelude_client_profile_t *cp);
Gets the GID associated with cp.
| 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.
| cp : | Pointer to a prelude_client_profile_t object. |
| name : | 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.
| cp : | 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.
| 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.
| cp : | Pointer to a prelude_client_profile_t object. |
| analyzerid : | Analyzer ID to be used by cp. |
int prelude_client_profile_get_credentials
(prelude_client_profile_t *cp,
void **credentials);
| cp : | |
| credentials : | |
| Returns : |