okay, let's copy the API doc manually... :-/
parent
592ff77262
commit
89d5df0ebb
|
@ -0,0 +1,317 @@
|
|||
### Detailed Function reference for the p≡p JSON Server Adapter. Version “(29) Wenden” ###
|
||||
Output parameters are denoted by a **⇑** , InOut parameters are denoted by a **⇕** after the parameter type.
|
||||
|
||||
Nota bene: This list was created manually from the "authorative API description" and might be outdated.
|
||||
|
||||
#### Message API ####
|
||||
|
||||
##### MIME_encrypt_message( String mimetext, Integer size, StringList extra, String⇑ mime_ciphertext, PEP_enc_format env_format, Integer flags)
|
||||
|
||||
encrypt a MIME message, with MIME output
|
||||
|
||||
```
|
||||
parameters:
|
||||
mimetext (in) MIME encoded text to encrypt
|
||||
size (in) size of input mime text
|
||||
extra (in) extra keys for encryption
|
||||
mime_ciphertext (out) encrypted, encoded message
|
||||
enc_format (in) encrypted format
|
||||
flags (in) flags to set special encryption features
|
||||
|
||||
return value:
|
||||
PEP_STATUS_OK if everything worked
|
||||
PEP_BUFFER_TOO_SMALL if encoded message size is too big to handle
|
||||
PEP_CANNOT_CREATE_TEMP_FILE
|
||||
if there are issues with temp files; in
|
||||
this case errno will contain the underlying
|
||||
error
|
||||
PEP_OUT_OF_MEMORY if not enough memory could be allocated
|
||||
```
|
||||
*Caveat:* the encrypted, encoded mime text will go to the ownership of the caller; mimetext
|
||||
will remain in the ownership of the caller
|
||||
|
||||
|
||||
##### MIME_encrypt_message_for_self(Identity target_id, String mimetext, Integer size, String⇑ mime_ciphertext, PEP_enc_format enc_format, Integer flags)
|
||||
|
||||
encrypt MIME message for user's identity only, ignoring recipients and other identities from
|
||||
the message, with MIME output.
|
||||
|
||||
```
|
||||
parameters:
|
||||
target_id (in) self identity this message should be encrypted for
|
||||
mimetext (in) MIME encoded text to encrypt
|
||||
size (in) size of input mime text
|
||||
mime_ciphertext (out) encrypted, encoded message
|
||||
enc_format (in) encrypted format
|
||||
flags (in) flags to set special encryption features
|
||||
|
||||
return value:
|
||||
PEP_STATUS_OK if everything worked
|
||||
PEP_BUFFER_TOO_SMALL if encoded message size is too big to handle
|
||||
PEP_CANNOT_CREATE_TEMP_FILE
|
||||
if there are issues with temp files; in
|
||||
this case errno will contain the underlying
|
||||
error
|
||||
PEP_OUT_OF_MEMORY if not enough memory could be allocated
|
||||
```
|
||||
|
||||
|
||||
##### MIME_decrypt_message(String, Integer, String⇑, StringList⇑, PEP_rating⇑, Integer⇑ )
|
||||
|
||||
decrypt a MIME message, with MIME output
|
||||
```
|
||||
parameters:
|
||||
mimetext (in) MIME encoded text to decrypt
|
||||
size (in) size of mime text to decode (in order to decrypt)
|
||||
mime_plaintext (out) decrypted, encoded message
|
||||
keylist (out) stringlist with keyids
|
||||
rating (out) rating for the message
|
||||
flags (out) flags to signal special decryption features
|
||||
|
||||
return value:
|
||||
decrypt status if everything worked with MIME encode/decode,
|
||||
the status of the decryption is returned
|
||||
(PEP_STATUS_OK or decryption error status)
|
||||
PEP_BUFFER_TOO_SMALL if encoded message size is too big to handle
|
||||
PEP_CANNOT_CREATE_TEMP_FILE
|
||||
if there are issues with temp files; in
|
||||
this case errno will contain the underlying
|
||||
error
|
||||
PEP_OUT_OF_MEMORY if not enough memory could be allocated
|
||||
```
|
||||
|
||||
|
||||
##### MIME_encrypt_message_ex(String, Integer, StringList, Bool, String⇑, PEP_enc_format, Integer )
|
||||
(deprecated)
|
||||
|
||||
##### MIME_decrypt_message_ex(String, Integer, Bool, String⇑, StringList⇑, PEP_rating⇑, Integer⇑ )
|
||||
(deprecated)
|
||||
|
||||
##### startKeySync()
|
||||
Start Key Synchronization for the current session.
|
||||
|
||||
##### stopKeySync()
|
||||
Stop Key Synchronization for the current session.
|
||||
|
||||
##### startKeyserverLookup()
|
||||
Start a global thread for Keyserver Lookup. This thread handles all keyserver communication for all sessions.
|
||||
|
||||
##### stopKeyserverLookup()
|
||||
Stop the global thread for Keyserver Lookup.
|
||||
|
||||
|
||||
##### encrypt_message(Message, StringList, Message⇑, PEP_enc_format, Integer)
|
||||
encrypt message in memory
|
||||
```
|
||||
parameters:
|
||||
src (in) message to encrypt
|
||||
extra (in) extra keys for encryption
|
||||
dst (out) pointer to new encrypted message or NULL on failure
|
||||
enc_format (in) encrypted format
|
||||
flags (in) flags to set special encryption features
|
||||
|
||||
return value:
|
||||
PEP_STATUS_OK on success
|
||||
PEP_KEY_NOT_FOUND at least one of the receipient keys
|
||||
could not be found
|
||||
PEP_KEY_HAS_AMBIG_NAME at least one of the receipient keys has
|
||||
an ambiguous name
|
||||
PEP_GET_KEY_FAILED cannot retrieve key
|
||||
PEP_UNENCRYPTED no recipients with usable key,
|
||||
message is left unencrypted,
|
||||
and key is attached to it
|
||||
```
|
||||
|
||||
##### encrypt_message_for_self(Identity, Message, Message⇑, PEP_enc_format, Integer)
|
||||
encrypt message in memory for user's identity only,
|
||||
ignoring recipients and other identities from
|
||||
the message.
|
||||
|
||||
```
|
||||
parameters:
|
||||
target_id (in) self identity this message should be encrypted for
|
||||
src (in) message to encrypt
|
||||
dst (out) pointer to new encrypted message or NULL on failure
|
||||
enc_format (in) encrypted format
|
||||
flags (in) flags to set special encryption features
|
||||
|
||||
return value: (FIXME: This may not be correct or complete)
|
||||
PEP_STATUS_OK on success
|
||||
PEP_KEY_NOT_FOUND at least one of the receipient keys
|
||||
could not be found
|
||||
PEP_KEY_HAS_AMBIG_NAME at least one of the receipient keys has
|
||||
an ambiguous name
|
||||
PEP_GET_KEY_FAILED cannot retrieve key
|
||||
```
|
||||
*Caveat:* message is NOT encrypted for identities other than the target_id (and then,
|
||||
only if the target_id refers to self!)
|
||||
|
||||
|
||||
##### decrypt_message(Message, Message⇑, StringList⇑, PEP_rating⇑, Integer⇑)
|
||||
decrypt message in memory
|
||||
```
|
||||
parameters:
|
||||
src (in) message to decrypt
|
||||
dst (out) pointer to new decrypted message or NULL on failure
|
||||
keylist (out) stringlist with keyids
|
||||
rating (out) rating for the message
|
||||
flags (out) flags to signal special decryption features
|
||||
|
||||
return value:
|
||||
error status
|
||||
or PEP_DECRYPTED if message decrypted but not verified
|
||||
or PEP_STATUS_OK on success
|
||||
|
||||
caveat:
|
||||
if src is unencrypted this function returns PEP_UNENCRYPTED and sets
|
||||
dst to NULL
|
||||
```
|
||||
|
||||
##### outgoing_message_rating(Message, PEP_rating⇑)
|
||||
get rating for an outgoing message
|
||||
```
|
||||
parameters:
|
||||
msg (in) message to get the rating for
|
||||
rating (out) rating for the message
|
||||
|
||||
return value:
|
||||
error status or PEP_STATUS_OK on success
|
||||
|
||||
caveat:
|
||||
msg->from must point to a valid pEp_identity
|
||||
msg->dir must be PEP_dir_outgoing
|
||||
```
|
||||
|
||||
##### re_evaluate_message_rating(Message, StringList, PEP_rating, PEP_rating⇑)
|
||||
re-evaluate already decrypted message rating
|
||||
```
|
||||
parameters:
|
||||
msg (in) message to get the rating for
|
||||
x_keylist (in) decrypted message recipients keys fpr
|
||||
x_enc_status (in) original rating for the decrypted message
|
||||
rating (out) rating for the message
|
||||
|
||||
return value:
|
||||
PEP_ILLEGAL_VALUE if decrypted message doesn't contain
|
||||
X-EncStatus optional field and x_enc_status is
|
||||
pEp_rating_udefined
|
||||
or if decrypted message doesn't contain
|
||||
X-Keylist optional field and x_keylist is NULL
|
||||
PEP_OUT_OF_MEMORY if not enough memory could be allocated
|
||||
|
||||
caveat:
|
||||
msg->from must point to a valid pEp_identity
|
||||
```
|
||||
|
||||
##### identity_rating(Identity, PEP_rating⇑)
|
||||
get rating for a single identity
|
||||
```
|
||||
parameters:
|
||||
ident (in) identity to get the rating for
|
||||
rating (out) rating for the identity
|
||||
|
||||
return value:
|
||||
error status or PEP_STATUS_OK on success
|
||||
```
|
||||
|
||||
##### get_gpg_path(String⇑)
|
||||
get path of gpg binary.
|
||||
|
||||
#### pEp Engine Core API ####
|
||||
##### log_event(String, String, String, String)
|
||||
|
||||
##### get_trustwords(Identity, Identity, Language, String⇑, Integer⇑, Bool)
|
||||
|
||||
##### get_languagelist(String⇑)
|
||||
|
||||
##### get_phrase(Language, Integer, String⇑)
|
||||
|
||||
##### get_engine_version | String | )
|
||||
|
||||
##### config_passive_mode | Void | Bool)
|
||||
|
||||
##### config_unencrypted_subject | Void | Bool)
|
||||
|
||||
|
||||
#### Identity Management API ####
|
||||
##### get_identity(String, String, Identity⇑)
|
||||
|
||||
##### set_identity(Identity)
|
||||
|
||||
##### mark_as_comprimized(String)
|
||||
|
||||
##### identity_rating(Identity, PEP_rating⇑)
|
||||
|
||||
##### outgoing_message_rating(Message, PEP_rating⇑)
|
||||
|
||||
##### set_identity_flags(Identity, Integer)
|
||||
|
||||
##### unset_identity_flags(Identity, Integer)
|
||||
|
||||
|
||||
#### Low level Key Management API ####
|
||||
##### generate_keypair(Identity⇕)
|
||||
|
||||
##### delete_keypair(String)
|
||||
|
||||
##### import_key(String, Integer, IdentityList⇑)
|
||||
|
||||
##### export_key(String, String⇑, Integer⇑)
|
||||
|
||||
##### find_keys(String, StringList⇑)
|
||||
|
||||
##### get_trust(Identity⇕)
|
||||
|
||||
##### own_key_is_listed(String, Bool⇑)
|
||||
|
||||
##### own_identities_retrieve(IdentityList⇑)
|
||||
|
||||
##### myself(Identity⇕)
|
||||
|
||||
##### update_dentity(Identity⇕)
|
||||
|
||||
##### trust_personal_key(Identity)
|
||||
|
||||
##### key_mistrusted(Identity)
|
||||
|
||||
##### key_reset_trust(Identity)
|
||||
|
||||
##### least_trust(String, PEP_comm_type⇑)
|
||||
|
||||
##### get_key_rating(String, PEP_comm_type⇑)
|
||||
|
||||
##### renew_key(String, Timestamp)
|
||||
|
||||
##### revoke(String, String)
|
||||
|
||||
##### key_expired(String, Integer, Bool⇑)
|
||||
|
||||
|
||||
#### from blacklist.h & OpenPGP_compat.h ####
|
||||
##### blacklist_add(String)
|
||||
|
||||
##### blacklist_delete(String)
|
||||
|
||||
##### blacklist_is_listed(String, Bool⇑)
|
||||
|
||||
##### blacklist_retrieve(StringList⇑)
|
||||
|
||||
##### OpenPGP_list_keyinfo(String, StringPairList⇑)
|
||||
|
||||
|
||||
#### Event Listener & Results ####
|
||||
##### registerEventListener(String, Integer, String)
|
||||
|
||||
##### unregisterEventListener(String, Integer, String)
|
||||
|
||||
##### deliverHandshakeResult(Identity, PEP_sync_handshake_result)
|
||||
|
||||
|
||||
#### Other ####
|
||||
##### version()
|
||||
|
||||
##### apiVersion()
|
||||
|
||||
##### getGpgEnvironment()
|
||||
|
||||
|
Loading…
Reference in New Issue