Update AIDL-Doc

This commit is contained in:
Markus Doits 2011-01-17 22:16:57 +00:00
parent f9ee141ce1
commit dc02a74d52

View File

@ -2,39 +2,41 @@ package org.thialfihar.android.apg;
interface IApgService { interface IApgService {
/** All functions fill the return_vals Bundle with the following keys: /* All functions fill the return_vals Bundle with the following keys:
* *
* ArrayList<String> "WARNINGS" = Warnings, if any * ArrayList<String> "WARNINGS" = Warnings, if any
* ArrayList<String> "ERRORS" = Human readable error descriptions, why function call failed * ArrayList<String> "ERRORS" = Human readable error descriptions, why function call failed
* int "ERROR" = Numeric representation of error * int "ERROR" = Numeric representation of error
*/ */
/** Encryption function's arguments /* Encryption function's arguments
* *
* Bundle params' keys: * Bundle params' keys:
* (optional/required) TYPE "STRING KEY" = EXPLANATION / VALUES * (optional/required) TYPE "STRING KEY" = EXPLANATION / VALUES
* *
* (required) String "MSG" = Message to encrypt * (required) String "MSG" = Message to encrypt
* (optional) int "ENCRYPTION_ALGO" = Encryption Algorithm * (optional) int "ENCRYPTION_ALGO" = Encryption Algorithm
* 7: AES-128, 8: AES-192, 9: AES-256, * 7: AES-128, 8: AES-192, 9: AES-256,
4: Blowfish, 10: Twofish, 3: CAST5, * 4: Blowfish, 10: Twofish, 3: CAST5,
6: DES, 2: Triple DES, 1: IDEA * 6: DES, 2: Triple DES, 1: IDEA
* (optional) int "HASH_ALGO" = Hash Algorithm * (optional) int "HASH_ALGO" = Hash Algorithm
1: MD5, 3: RIPEMD-160, 2: SHA-1, * 1: MD5, 3: RIPEMD-160, 2: SHA-1,
11: SHA-224, 8: SHA-256, 9: SHA-384, * 11: SHA-224, 8: SHA-256, 9: SHA-384,
10: SHA-512 * 10: SHA-512
* (optional) Boolean "ARMORED" = Armor output * (optional) Boolean "ARMORED" = Armor output
* (optional) Boolean "FORCE_V3_SIG" = Force V3 Signatures * (optional) Boolean "FORCE_V3_SIG" = Force V3 Signatures
* (optional) int "COMPRESSION" = Compression to use * (optional) int "COMPRESSION" = Compression to use
0x21070001: none, 1: Zip, 2: Zlib, * 0x21070001: none, 1: Zip, 2: Zlib,
3: BZip2 * 3: BZip2
* (optional) String "SIGNATURE_KEY" = Key to sign with
* (optional) String "SIGNATURE_KEY_PASS" = Passphrase for signing key
* *
* Bundle return_vals (in addition to the ERRORS/WARNINGS above): * Bundle return_vals (in addition to the ERRORS/WARNINGS above):
* String "RESULT" = Encrypted MSG * String "RESULT" = Encrypted MSG
*/ */
/* Additional argument: /* Additional argument:
* (required) String "SYM_KEY" = Symmetric key to use * (required) String "SYM_KEY" = Symmetric key to use
*/ */
boolean encrypt_with_passphrase(in Bundle params, out Bundle return_vals); boolean encrypt_with_passphrase(in Bundle params, out Bundle return_vals);
@ -45,14 +47,15 @@ interface IApgService {
boolean encrypt_with_public_key(in Bundle params, out Bundle return_vals); boolean encrypt_with_public_key(in Bundle params, out Bundle return_vals);
/** Decrypt something /* Decrypt something
* *
* Bundle params: * Bundle params:
* (required) String "MSG" = Message to decrypt * (required) String "MSG" = Message to decrypt
* (optional) String "SYM_KEY" = Symmetric key to use if encryption is symmetric * (optional) String "SYM_KEY" = Symmetric key to use if encryption is symmetric
* (optional) String "PRIVATE_KEY_PASS" = Private keys's passphrase on asymmetric encryption
* *
* Bundle return_vals: * Bundle return_vals:
* String "RESULT" = Decrypted MSG * String "RESULT" = Decrypted MSG
*/ */
boolean decrypt(in Bundle params, out Bundle return_vals); boolean decrypt(in Bundle params, out Bundle return_vals);
} }