MacPGP 2.6.3 Apple Event Suite Required Events ('aevt') 1) Open Application ('oapp') Parameters: None Actions performed: MacPGP doesn't do anything special in response to this event. 2) Open Documents ('odoc') Parameters: i) Direct object ('----') AE list of files to be processed (type 'alis') Actions performed: For each file on the list: i) If the file is a binary or armored PGP encoded/signed/key file, it is passed to the PGP engine for decryption/verification. If it contains public or secret keys, they will be added to the appropriate default key rings. ii) If the file is in MacBinary format, it is converted to a Macintosh file, with data fork, resource fork and Finder information. iii) If the file has a header line "# PGP Command File", the commands in each of the following lines are executed, one by one. NB. If the file is not MacBinary or a PGP Command or text file and doesn't have creator 'MPGP', you will be warned before the file is passed to the PGP engine. 3) Print Documents ('pdoc') MacPGP doesn't support this event. You will get the error message "MacPGP is unable to fulfill this request." 4) Quit Application ('quit') Parameters: None Actions performed: MacPGP cleans up and quits. MacPGP AE Suite ('MPGP') 1) encrypt ('encr') (Encrypt files) Parameters: i) Direct object ('----') AE list of files to be encrypted (type 'alis') ii) to ('recv') AE list of recipients (type 'TEXT') iii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). iv) signature ('sign') Should the files be signed too? (type enumerated 'sige', one of: separated ('sepa') - create separate signatures included ('incl') - attach signatures to the files before encrypting them omitted ('omit') - don't sign the files to be encrypted) This parameter is optional. It defaults to omitted. v) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. vi) writing ('outp') How to treat the output files. (type enumerated 'outp', one of: binary ('bina') - leave encrypted output files in binary 8-bit format asciified ('asci') - asciify the encrypted output files) This parameter is optional. It defaults to binary. vii) wipesource ('wipe') Wipe out input files after encypting them? (type boolean 'bool') This parameter is optional. It defaults to false. viii) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. ix) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. x) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. xi) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. xii) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. xiii) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the file, if signing. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: Each file in the direct object parameter list is encrypted/signed according to the options specified in the other parameters. The names of the encrypted/signed files are returned in an AE file alias list parameter to the reply Apple Event labelled with the keyword 'outp' 2) encryptData ('ncrd') (Encrypt data in memory) Parameters: i) Direct object ('----') The data in memory to be encrypted/signed. Must be less than 32K bytes in size. (type 'TEXT') This parameter is optional. If not specified will look for the data in the Clipboard instead. ii) to ('recv') AE list of recipients (type 'TEXT') iii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). iv) signature ('sign') Should the files be signed too? (type enumerated 'sige', one of: separated ('sepa') - create separate signatures included ('incl') - attach signatures to the files before encrypting them omitted ('omit') - don't sign the files to be encrypted) This parameter is optional. It defaults to omitted. v) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. vi) writing ('outp') How to treat the output files. (type enumerated 'outp', one of: binary ('bina') - leave encrypted output files in binary 8-bit format asciified ('asci') - asciify the encrypted output files) This parameter is optional. It defaults to binary. vii) wipesource ('wipe') Wipe out input files after encypting them? (type boolean 'bool') This parameter is optional. It defaults to false. viii) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. ix) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. x) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. xi) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. xii) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. xiii) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the data, if signing. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: The data in memory is encrypted/signed according to the specified options. The encrypted/signed data is returned as the direct parameter to the reply Apple Event of type 'TEXT', unless the input data came from the Clipboard. In that case, the encrypted/ signed data is put into the Clipboard, replacing the input data. (All temporary files are wiped by PGP.) 3) cencrypt ('encr') (Conventionally encrypt files) Parameters: i) Direct object ('----') AE list of files to be encrypted (type 'alis') ii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). iii) signature ('sign') Should the files be signed too? (type enumerated 'sige', one of: separated ('sepa') - create separate signatures included ('incl') - attach signatures to the files before encrypting them omitted ('omit') - don't sign the files to be encrypted) This parameter is optional. It defaults to omitted. iv) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. v) writing ('outp') How to treat the output files. (type enumerated 'outp', one of: binary ('bina') - leave encrypted output files in binary 8-bit format asciified ('asci') - asciify the encrypted output files) This parameter is optional. It defaults to binary. vi) wipesource ('wipe') Wipe out input files after encypting them? (type boolean 'bool') This parameter is optional. It defaults to false. vii) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. viii) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. ix) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. x) CPassword ('pass') Password to be used for encrypting the files. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. xi) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. xii) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. xiii) coptions ('copt') Make into self-decrypting file and binhex? (type enumerated 'copt', one of: selfdecrypting ('sdf ') - make the file into a selfdecrypting application binhexedsdf ('sdfb') - selfdecrypting and then binhexed) This parameter is optional. If not specified, neither option will be applied. xiv) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the file, if signing. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: Each file in the direct object parameter list is encrypted/signed according to the options specified in the other parameters. The names of the encrypted/signed files are returned in an AE file alias list parameter to the reply Apple Event labelled with the keyword 'outp' 4) sign ('sign') (Sign files) Parameters: i) Direct object ('----') AE list of files to be signed (type 'alis') ii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). iii) signature ('sign') Type of signature to be used (type enumerated 'sigs', one of: separated ('sepa') - create separate signatures included ('incl') - attach opaque signatures to the files clear ('clea') - attach clear signatures to the files This parameter is optional. It defaults to the setting in the PGP Preferences file or config.txt, otherwise to clear. iv) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. v) writing ('outp') How to treat the output files. (type enumerated 'outp', one of: binary ('bina') - leave encrypted output files in binary 8-bit format asciified ('asci') - asciify the encrypted output files) This parameter is optional. It defaults to binary. vi) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. vii) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. viii) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. ix) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. x) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. xi) textFlag ('stxf') Set the text mode flag in a detached signature, even though the MD5 hash is computed in binary mode. (This is an esoteric option intended for use by certain PGP/Mime implementations.) (type boolean 'bool') This parameter is optional, defaults to false. xii) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the file. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: Each file in the direct object parameter list is signed according to the options specified in the other parameters. The names of the encrypted/signed files are returned in an AE file alias list parameter to the reply Apple Event labelled with the keyword 'outp' 5) signData ('sigd') (Sign data in memory) Parameters: i) Direct object ('----') The data in memory to be signed. Must be less than 32K bytes in size. (type 'TEXT') This parameter is optional. If not specified will look for the data in the Clipboard instead. ii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). iii) signature ('sign') Type of signature to be used (type enumerated 'sigs', one of: separated ('sepa') - create separate signatures included ('incl') - attach opaque signatures to the files clear ('clea') - attach clear signatures to the files This parameter is optional. It defaults to the setting in the PGP Preferences file or config.txt, otherwise to clear. iv) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. v) writing ('outp') How to treat the output files. (type enumerated 'outp', one of: binary ('bina') - leave encrypted output files in binary 8-bit format asciified ('asci') - asciify the encrypted output files) This parameter is optional. It defaults to binary. vi) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. vii) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. viii) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. ix) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. x) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. xi) textFlag ('stxf') Set the text mode flag in a detached signature, even though the MD5 hash is computed in binary mode. (This is an esoteric option intended for use by certain PGP/Mime implementations.) (type boolean 'bool') This parameter is optional, defaults to false. xii) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the data. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: The data in memory is signed according to the specified options. The signed data is returned as the direct parameter to the reply Apple Event of type 'TEXT', unless the input data came from the Clipboard. In that case, the signed data is put into the Clipboard, replacing the input data. (All temporary files are wiped by PGP.) 6) decrypt ('decr') (Decrypt files) Parameters: i) Direct object ('----') AE list of files to be decrypted (type 'alis') ii) toScreen ('scre') - decrypted file should only be displayed in the PGP messages window, not written to a file? (type boolean 'bool') This parameter is optional, defaults to false. iii) to ('recv') Save decrypted file to this (type FSSpec 'fss ') This parameter is optional, otherwise the usual pgp default (drop the '.pgp' or '.asc' suffix or ask the user). iv) Password ('pass') Password to be used for decrypting (either conventional or public key). (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. v) NoSignAlert ('nsig') Do not put up alerts about bad signatures, use reply direct object instead? (type boolean 'bool') This parameter is optional, defaults to false. vi) appliesTo ('apl2') If direct object is a separated signature file, the file the signature applies to. (type 'alis') This parameter is optional. Actions performed: Each file in the direct object parameter list is decrypted. The names of the decrypted files are returned in an AE file alias list parameter to the reply Apple Event labelled with the keyword 'outp'. If there are signatures on any of the files, the signature results are returned as as list of strings (type 'TEXT') in the direct object parameter to the reply Apple Event. 7) decryptData ('dcrd') (Decrypt data) Parameters: i) Direct object ('----') The data in memory to be decrypted. Must be less than 32K bytes in size. (type 'TEXT') This parameter is optional. If not specified will look for the data in the Clipboard instead. ii) toScreen ('scre') - decrypted file should only be displayed in the PGP messages window, not returned? (type boolean 'bool') This parameter is optional, defaults to false. iii) Password ('pass') Password to be used for decrypting (either conventional or public key). (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. iv) NoSignAlert ('nsig') Do not put up alerts about bad signatures, use CheckSignResult Apple Event instead? (type boolean 'bool') This parameter is optional, defaults to false. v) appliesTo ('apl2') If direct object is a separated signature file, the file the signature applies to. (type 'alis') This parameter is optional. Actions performed: The data in memory is decrypted. The decrypted data is returned as the direct parameter to the reply Apple Event of type 'TEXT', unless the input data came from the Clipboard. In that case, the signed data is put into the Clipboard, replacing the input data. (All temporary files are wiped by PGP.) 8) execute ('exec') (Execute a DOS-like command line) Parameters: i) Direct object ('----') the command line (type 'TEXT') ii) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. iii) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. iv) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. v) Password ('pass') Password to be used for unlocking secret key for signing. (type 'TEXT') This parameter is optional. If not specified, will prompt the user for it. vi) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. vii) Message Digest ('mdal') Specifies whether to use MD5 or SHA1 to compute message digest for the file, if signing. (type enumerated 'mdal', one of 'MD5 ' or 'SHA1') This parameter is optional. If not specified, the current user default is used. Actions performed: The command line is passed to the PGP engine. 9) asciify ('asci') (Asciify files to send via EMail) Parameters: i) Direct object ('----') AE list of files to be asciified (type 'alis') ii) reading ('read') How to treat the input files. (type enumerated 'read', one of: MacBinary ('macb') - MacBinarize the file before encrypting/signing plaintext ('text') - Convert the line endings from Macintosh (CR) form to canonical (CR-LF) form before encrypting/ signing the files. normal ('norm') - Don't do any conversions before encrypting/signing the files) This parameter is optional. It defaults to normal. iii) ISOLatin1 ('lati') Convert text to ISO-Latin1? (type boolean 'bool') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise false. iv) Wrapping ('wrap') Wrap text to this many characters per line. Must be between 30 and 100, or 0 which means do not wrap. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise will not wrap. v) Armorlines ('alns') Split armored output into files having at most these many lines. Armorlines=0 means do not split up. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences or config.txt, otherwise 720. vi) expandTabs ('tabx') Expand tabs to this many spaces. Must be used in conjunction with Wrapping and must have value between 0 (no tab expansion) to 9. (type short 'shor') This parameter is optional. If not specified, will use the setting in PGP Preferences, otherwise 0. Actions performed: Each file in the direct object parameter list is asciified. The names of the decrypted files are returned in an AE file alias list parameter to the reply Apple Event labelled with the keyword 'outp' 10) stealthify ('stlh') (Stealthify a file) Parameters: i) Direct object ('----') File to be stealthified (type 'alis') ii) saving in ('save') Stealthed file (type 'fss ') Actions performed: PGP encrypted file named in the direct parameter is stealthified and the resulting stealthed file is saved with the name given in the other parameter. 11) destealthify ('dstl') (Destealthify a file) Parameters: i) Direct object ('----') File to be destealthified (type 'alis') ii) saving in ('save') Destealthed file (type 'fss ') iii) to ('recv') Destealthify as file as public key encrypted to this user id. (type 'TEXT') This parameter is optional. If not specified, will assume the file is to be destealthified either as encrypted to the default user id or conventionally encrypted. iv) conventional ('conv') If true destealthify as conventionally encrypted file. (type boolean 'bool') This parameter is optional. Default is false. v) decrypt ('decr') Decrypt file after destealthifying? (type boolean 'bool') This parameter is optional. Default is false. Actions performed: PGP encrypted file named in the direct parameter is destealthified. If decrypt is true, the destealthified file is decrypted. The final output file is saved with the name given in the 'saving in' parameter. 12) create ('crea') (Create a new temporary scratch file) Parameters: i) Direct object ('----') Name to be given to new file (type 'TEXT') (should be full path name). Actions performed: New file with given name is created. (If file already exists, it is erased.) 13) clip2file ('sc2f') (Copy Clipboard to file) Parameters: i) Direct object ('----') Pathname for destination file (type 'TEXT') Actions performed: Clipboard is copied to the given file. 14) file2clip ('f2sc') (Copy file to Clipboard) Parameters: i) Direct object ('----') Pathname for source file (type 'TEXT') Actions performed: Contents of given file is copied to the Clipboard (as 'TEXT') 15) add ('addk') (Add one or more keys to a key ring) Parameters: i) Direct object ('----') The file containing the key(s) to be added (type 'alis') ii) key ring ('keyr') Add the key(s) to this key ring. (type 'fss ') This parameter is optional. If not present, the key(s) are added to the default public keyring (for public keys) or to the default secret keyring (for secret keys). Actions performed: Contents of given keyfile are added to the keyring 16) extract ('extr') (Take a key from a key ring and save it into a file) Parameters: i) Direct object ('----') The user id of the key to be extracted. (type 'TEXT') ii) to ('recv') The file to save the key into (type FSSpec 'fss ') iii) key ring ('keyr') Extract the key from this key ring. (type 'fss ') This parameter is optional. If not present, the key is extracted from the default public keyring. iv) writing ('outp') How to treat the output file. (type enumerated 'outp', one of: binary ('bina') - leave extracted key in binary 8-bit format asciified ('asci') - asciify the extracted key) This parameter is optional. It defaults to binary. Actions performed: Requested key is extracted to the given file. 17) remove ('remv') (Remove a key from a key ring) Parameters: i) Direct object ('----') The user id of the key to be removed. (type 'TEXT') ii) key ring ('keyr') Remove the key from this key ring. (type 'fss ') This parameter is optional. If not present, the key is removed from the default public keyring. Actions performed: Requested key is removed from the keyring. 18) certify ('crfy') (Sign a public key) Parameters: i) Direct object ('----') The user id of the key to be certified. (type 'TEXT') ii) key ring ('keyr') The key ring containing the key to be certified. (type 'fss ') This parameter is optional. If not present, the key is assumed to be in the default public keyring. iii) user id ('usid') The name of the secret key to be used for signing (type 'TEXT') This parameter is optional. It defaults to the default userid specified in PGP Preferences or config.txt, or to the first secret key in the default secret keyring (in that order). Actions performed: Requested key is certified using the specified secret key. 19) fingerprint ('fing') (Calculate a key's fingerprint) Parameters: i) Direct object ('----') The user id of the key to be fingerprinted. (type 'TEXT') ii) key ring ('keyr') The key ring containing the key to be fingerprinted. (type 'fss ') This parameter is optional. If not present, the key is assumed to be in the default public keyring. Actions performed: Fingerprint for requested key is returned as the direct parameter to the reply Apple Event (as type 'TEXT'). 20) generate ('gene') (Generate a public/secret key pair) Parameters: i) Direct object ('----') The user id of the key to be generated. (type 'TEXT') ii) length ('leng') The key length / security grade (type enumerated 'grad', one of: casual ('casu') - 512 bits commercial ('comm') - 768 bits military ('mili') - 1024 bits) This parameter is optional, defaults to casual. iii) keyBits ('kbit') The bit length of the key to be generated. (Alternative to length parameter) Must be between 384 and 2048. (type short 'shor') This parameter is optional. If not specified, will use the length parameter. iv) ebits ('ebit') The number of bits in the encryption exponent. (type short 'shor') This parameter is optional, defaults to 17. Actions performed: Generates a public/secret key pair according to specifications and adds them to the default public/secret keyrings. 21) countKeys ('ckey') (Count the number of keys in a keyring whose userid match a given string) Parameters: i) Direct object ('----') The string to be matched (type 'TEXT') ii) key ring ('keyr') The key ring containing the keys to be matched. (type 'fss ') This parameter is optional. If not present, the keys are assumed to be in the default public keyring. Actions performed: Returns the number of keys matched as direct object parameter to the reply Apple Event (type 'long'). (Returns -1 or an error, if keyring can't be found, etc.) 22) selectAKey ('selk') (Select a key from a dialog) Parameters: i) Direct object ('----') The message to be displayed in the dialog. (type 'TEXT') This parameter is optional, defaulting to "Please select a key" ii) key ring ('keyr') The key ring containing the key to be selected. (type 'fss ') This parameter is optional. If not present, the dialog displays the keys in the default public keyring. Actions performed: This Apple Event causes a key selection dialog to be displayed. The selected userid is returned as the direct object parameter to the reply Apple Event (type 'TEXT') (The empty string is returned if the dialog is cancelled.) 23) checkSignResult ('cksg') (Check signature result from previous decryptData Event) Parameters: None Actions performed: Returns the signature result from the last decryptData Apple Event as direct object parameter to the reply Apple Event (type 'TEXT'). 24) checkSignResult ('gler') (Get error message from previous MacPGP Apple Event) Parameters: None Actions performed: Returns the error message from the last Apple Event as direct object parameter to the reply Apple Event (type 'TEXT'). (Returns empty string if there was no error.) 25) getVersion ('gvers') (Get version string) Parameters: None Actions performed: Returns the version string ("MacPGP 2.6.3 v. 1.6 - June 27, 1996") as direct parameter to the reply Apple Event (type 'TEXT'). 26) window ('wind') (Show or hide the PGP Messages window) Parameters: i) Direct object ('----') whether to show or hide type enumerated 'wind', one of: show ('show') hide ('hide') Actions performed: If the 'hide' message is recieved, MacPGP will hide its messages window while processing Apple Events or whenever it is in the background. Normal display of PGP windows will resume after the 'show' message is recieved, or if the user pulls down any of the MacPGP menus. 27) Logfile ('logf') (Echoing the PGP Messages window to a file) Parameters: i) Direct object ('----') whether to show or hide type boolean 'bool' true = activate echoing false = deactivate echoing This parameter is optional. ii) to ('recv') type alias 'alis', specifies the file to be used for echoing the Messages window. This parameter is optional. Actions performed: Always returns the full path name (type 'TEXT') of the log file which was active prior to recieving this AppleEvent, or the empty string if there was none. If the direct object is true and logging was not active prior to this AppleEvent, activates logging to the file specified in the 'to' parameter. It returns an error if logging was already active, or if no log file is specified. If the direct object parameter is false, deactivates logging if it was active, otherwise just returns the empty string.