Translated manuals

Peics/Empic Pro 1.25 manual

  1. Introduction
  2. System requirements
  3. Installation
  4. How to start
  5. Using the program
  6. Settings dialog box (PEICS.INI configuration file)
  7. Miscellaneous

1. Introduction

Peics is a PGP-shell that runs as an EMSAPI plug-in extension to Eudora 3.0. Empics is a program that attaches to previous Eudora versions. This manual describes them both, because they are very similar. So please read "Empics" instead of "Peics" if you are using that version.

PGP (Pretty Good Privacy, written by Philip Zimmermann) is a DOS-program and a very good public key encryption of text files. Eudora from QUALCOMM is a very popular mail program for MS-Windows. Peics is just an interface between these programs. It does not replace either of them.

Without a PGP-shell it is cumbersome to reply to coded mail. You have to save the received mail in a file; go to DOS; PGP-decode it; return to Windows if you prefer a Windows editor; type an answer; go back to DOS; PGP-code the file; and then return to Windows, paste the encrypted message in Eudora and send the file. With Peics you can run PGP from Eudora's menu or by pushing a button on Eudora's toolbar.

Peics finds out what to do. First it copies the data in the current window to a textfile on disk. Then it starts PGP.EXE in a DOS-box and specifies the right command-line to decode or encrypt the text. The decoded text is returned in the current window if possible. Otherwise you can paste it into an editor of your choice. The encrypted text is always put in the current window.

Peics Pro is not freeware nor shareware. You will need a license from Comerwell Software to use it. You can get a temporary license if you fill out the registration page. You can only do this once for one e-mail address.
You do not have to read the entire manual. I'm sorry for writing so much. Read at least sections 2, 3, 4 and the start of section 5. Then run the program, see if and how it works. Then run the program and see if and how it works. If you can't figure something out, read the appropriate section and try again.

2. System requirements

The unzipped package uses around 360 kByte disk space (both programs and manual). The program is about 160 kByte and uses almost no extra memory. You do not need any VBX-control libraries or additional DLL.

Do not expect, that it will always work with beta versions of Eudora.

Peics(16)

You need a 80286 computer (or better) and MS-Windows 3.1 or Windows95. I do not think this version runs on OS/2 Windows. It seems that Peics does not get a notification message that PGP has terminated. I will try to find out exactly what fails but I do not have OS/2 -- which complicates things.

For Peics you will need Eudora(16) 3.0 or later, for Empics(16) please use Eudora(16) 1.5.2, 1.5.4, 2.1.2 or 2.2. It does not run with 32-bit versions of Eudora.

Peics(32)

You need a 80386 computer (or better) and Windows95 or NT and Eudora(32) 3.0 or later. For Empics(32) you need Eudora(32) 1.5.4 or 2.2. The 32 bit version does not work with Eudora (16). Although it should also work with the 16 bit PGP you may want to try pgp 2.6.3i compiled for win32, available from the International PGP homepage for everyone outside the USA or Canada.
Return to top

3. Installation

Unzip the ZIP-file with PKZIP version 2.04g (or later). In this ZIP-file you will find another ZIP-file (PEICS.ZIP) and a signature (SIG) file. Unzip PEICS.ZIP and copy the program Peics(16) PEICS16.DLL or Peics(32) PEICS32.DLL and PEICS.LIC to Eudora's PLUGINS directory. PEICS.LIC will be shown when you run the program for the first time. You can buy the special license PEICS.LIC for Peics Pro from Comerwell Software.

If you don't like to have those files in the PLUGINS directory, you can also create a subdirectory PEICS under PLUGINS. Peics searches them there if the directory exists. The main PEICS??.DLL must be in PLUGINS, because Eudora must load it.

Peics reads module information from Eudora, which will be saved in the [ModuleDefinition] section in PEICS.INI. Peics knows about specific Eudora versions. If you use another, you will see a dialog box from which you can choose a module definition. If everything worked fine, you can save the module definition for later use. This information is saved in the [SelectedModDefinition] section in PEICS.INI.

This version can load a language module. A German module will soon be on the language support page. The file must be named "pl16?*.dll" (16-bit) or "pl32?*.dll" (32-bit). The "?*" is a language identifier, so the 32-bit German version will be "pl32de.dll". The first file that matches this name will be loaded from the PLUGINS directory (or the PEICS directory if that one exists). You can also set the name in PEICS.INI. Peics will use the internal English data if the file cannot be found.

If Eudora is currently running, the new addition of this software will not show up. Close Eudora and re-launch.

Empics Installation differences
Eudora versions under 3 do not load Plug-in DLL's, so Empics must load itself. This implies a different installation procedure.
Copy the files
The program Empics(16) is EMPICS16.EXE and Empics(32) is both EMPICS32.EXE and MP32.DLL. You can copy the program where you like, but it is maybe a good idea to make a PEICS directory under the EUDORA directory and copy all files there. The files PEICS.INI and PEICS.LIC are the same for both Empics and Peics, so they have PEICS in the name (so please do not read "EMPICS" here :-).
Adding Empics icon
Open Eudora's program group. Choose "File | New..." in Windows program manager, select "OK", choose "Browse" and select the Eudora directory. Select the program file (EMPICS16.EXE or EMPICS32.EXE).
The first run of Empics
Now you should first launch Eudora. Then click the just created icon to start Empics. It should find Eudora. If it does not find a known version, you will see the module dialog box as described above under Peics Installation. When you exit Eudora (and Empics), the complete pathname of the module (EUDORA.EXE) is saved, so that it can be started automatically. Next time you can run Empics and it will load Eudora.
PGP Configuration
If you have installed PGP correctly, the plug-in should work now. Check that you have the environment variable PGPPATH set to the PGP-directory. Peics(16) searches in this directory for PGP.PIF or PGP.EXE. Peics (32) only searches for PGP.EXE. If it does not find any, it searches the DOS PATH. If it still cannot find anything, you will get the "Peics settings..." dialog box, where you can set the correct path to the PGP.EXE (or PGP.PIF) file. If you choose [Cancel] the search fails and the program stops.
In Windows 3.x
On a 80386 PC (or better) you can edit/create PGP.PIF to run in a DOS-Window [instead of full screen textmode]. As well, you can choose to keep the DOS-box open after PGP has terminated. Then you can see the results of PGP. There's a PGP.PIF file included in this distribution. I do not promise that it works, but it might be a good starting point for creating your own.
In Windows 95
Windows 95 does not have a PIF-editor anymore [although PIF-files are still supported], but you can set the options for the file PGP.EXE instead. In "My computer" click on the pgp icon; choose "File | Properties" from the menu; choose "Program" and un-check "Close on exit". For the 32-bit international PGP program, you cannot set this. Instead you can tell Peics to keep the window open. This is a good alternative which also works for PGP (16).
Temporary files
Both Peics and PGP need to create temporary files, which may contain the texts being encrypted. A parameter in PGP's configuration file tells them where those files should go to.

Peics first reads PGP's configuration file (CONFIG.TXT or PGP.INI) from the directory specified by the PGPPATH environmental variable. If it finds a TMP= entry, it will use that directory, otherwise it uses the directory specified by the TMP environmental variable. This is exactly how PGP does this. See section "Setting Parameters in the PGP Configuration File" in PGPDOC2.TXT (PGP's documentation).

It's recommended to set the TMP parameter in PGP's CONFIG.TXT or PGP.INI to a RAM-drive, because this will guarantee that there are no stale (chunks of) files left on the disk when the system or the program hangs.

If the directory for temporary files has not been found, yet, then Peics tries the TEMP environmental variable and the PGPtempdir parameter in PEICS.INI.

If the files exist on start-up, you will be prompted if they can be overwritten. If you choose "Cancel" the program terminates without overwriting them.

More users
If you use Eudora with more users (and more pop-accounts), you may have specified a command-line for Eudora in Program Managers "File | Properties". Then each user can have his own start-up icon and his own mail directory. Eudora passes the mail-directory+PLUGINS as the configuration directory to Peics. So if C:\MAIL\BILL is your mail directory, C:\MAIL\BILL\PLUGINS is passed to Peics, but Peics will also search in the mail directory (e.g.: "C:\MAIL\BILL"). So each user can have his own configuration PEICS.INI in his mail directory. (See section 6. PEICS.INI)

The license file PEICS.LIC will be searched in this configuration directory and in the PLUGINS directory under the Eudora directory. If you have a license for more users, then you'd better store the file under the Eudora directory. If you have a license for yourself put it in your own configuration directory. Peics shows where it searched the file if it cannot be found. If it finds a file, it does not search for other PEICS.LIC files.

More users, Empics differences
Empics passes its command-line to Eudora, so copy the command-line setting from Eudora's start-up icon, if you want to have the same configuration, when running Empics. Empics reads the 'local' (user) configuration from the directory specified on the command-line , like Peics. The PLUGINS directory does not exist in previous Eudora versions, so Empics does not search there.

4. How to start

Start Eudora. It will load Peics, if the DLL is in the PLUGINS directory. [If Eudora is currently running, the new addition of this software will not show up. Close Eudora and re-launch.]
Empics differences
If Eudora is already running, then Empics will attach, otherwise it will first launch Eudora. You can also unload Empics from Eudora by choosing the "File | Exit PGP extension..." menu item.
Return to top

5. Using the program

This program is not a complete PGP-shell. If you need special features use another PGP-shell or go to the DOS-commandline. This program is intended for the common tasks. It can encrypt and decode mail, sign and check a signed message and add a public key to the public keyring. The program finds out what to do. This EMSAPI program offers 2 different ways to run PGP:
  1. The EMSAPI interface from the "Edit | Message plugins" menu.
  2. The window interface from the "Run PGP..." or the button on the right side of the toolbar.
Note: Early Eudora versions did not have the EMSAPI, so you cannot use method 1, unless you have Eudora 3 or later.

Every time you use PGP you will have to follow these instructions:

  1. Open the window where your text is.
  2. Run PGP in one of the ways shown before. The plug-in shows a dialog box with what it expects it should do. Choose [OK] if you agree to run PGP. See also General description of "Run PGP..." dialog box.
  3. When PGP has finished, close the DOS-window or type EXIT in DOS. You should read PGP's results from the DOS-window, so you'd better keep it open.
  4. After closing the DOS-box you see the changed text or a dialog box that tells what happened. If PGP returned an error code it will be shown here, but not in plain text. Usually this does not happen. If it does, PGP has already written an error message on screen.
Some definitions:
An "output window" is a window that has a "To:" field and is created with a "New", "Reply", or "Forward" menu-selection. In this window you can edit text.
An "input window" is a window with only text. It is created for incoming messages and can not be edited. In Eudora Pro 3.0 you can turn of this read-only mode though.
General description of "Run PGP..." dialog box
Peics always presents a complete dialog box when you have invoked the "Run PGP" command as described above. In the upper right corner you will see a "Basic functions" group box (a rectangle with some buttons in it). It is called "Basic functions", because this is where the start and the end is. The other selections you make in the dialog box depend on the choice of the 4 radio buttons "Decode", "Encrypt", "Sign", "Encrypt + Sign" , so you should first select one of those buttons. Peics Pro automatically makes a selection from those buttons based on the information it found in the text, but you can change this if you like. When you have completed the other settings, you click the [OK] button.

Depending on the selection of the 4 basic functions, different options are enabled. If you only want to sign a text, you do not need the "encrypt for" list- or edit-box, so this window is greyed. The "Decode" button may show "Check Sig" or "Add Key" depending on what Peics found in the text. The title of the dialog box shows what Peics thinks it should do. It also writes a descriptive message in the window in the upper left corner.

A line divides the dialog box in an upper and lower part. Just above this line you'll see the command-line that Peics passes to PGP. This is mostly informative, but it can edited if needed. If you make another change in the dialog box, the command-line will be overwritten. So after changing the command-line you should click [OK], if you want this change to be used.

The next sections assume that you are at section 2 of the description above and see the dialog box as just described.

5a. Decoding

If Peics found a PGP MESSAGE BEGIN/END block, it will select the "Decode" button of the 4 basic functions. This will decode the text from the BEGIN/END block.

Peics copies the text to the window where it came from. If this is a read-only window (usually an input window) you can only read the text. Everything else you try to do (forward, reply, save), will be done on the original encrypted text. As well as reading and scrolling you can copy a selection to the clipboard (Edit|Select All and Edit|Copy).

If you have sent an encrypted message from an output window you can later decode it, provided that you have also encrypted for yourself. But Eudora marks this output window as read-only, so you can only read the (decoded) text, as in the input window.

If you have set the INI-setting CopyToReadOnly = 0, then Peics shows a dialog box that lets you choose where you want your decoded text to go. It can copy the text to the clipboard (the default, [Yes]) or ([No]) to the textwindow, where it came from. If you chose to copy the text to the clipboard, you can paste your decoded text from the clipboard into an editor of your choice.

Decoding attachments
Incoming text attachments can be passed to PGP for decoding. I added this because some other mailer extensions put the encrypted text in an attachment. Moreover some key mailers send keys as attachment. The converted text will be put in the text in place of the "Attachment Converted: FILENAME" text. This enables you to decode more than one attachment in a message. Simply "run PGP" on them again.

The program reads the attached file and scans for a "-----PGP BEGIN" to see what it should do with the file. Then it does exactly what it normally does with a text in the window. It copies the text to a file (PEICS.ASC); passes that to PGP and inserts the result in the original text. If there's no PGP MESSAGE, KEY or SIGNATURE block in the file, then Peics just ignores the attachment. Attachment decoding can be turned off in the "Peics settings..." dialog box.

Now please do not start mailing me, saying that you cannot encrypt attachments that you make. I shall add this some time in the future, but I do not know when.

Key in decoded text
After decoding Peics scans the decoded text for a key. If it found one you will be prompted if you like to add it to your public keyring. See section 5c. Adding a new key.

There's an easier way to decode if you want to reply to an encrypted message. See section 5d. Reply to coded mail.

5b. Encrypting

If Peics finds no coded or signed text in an output window , it selects the Encrypt radio button and retrieves the names to encrypt for from the "To:"- and "CC:"- fields. If Peics could find the public keyring it will show a list box with the selected keys. Otherwise it will show an edit box with the names or e-mail addresses to encrypt for.

The dialog box only shows the keys of the names to encrypt for. If Peics cannot find a name, it will show the complete list with those names in plain text. If only the selected key list is shown, you can get the complete list by clicking on an item in the window. Then you can add keys if you like.

It's very convenient to have the e-mail address in the public key. PGP uses this address to find the key of the recipient. Peics can extract the e-mail address from the text in the "To:" field, if it finds an '@' sign. In the EMSAPI interface Peics gets the e-mail addresses from Eudora.

For signing options see 5e. Clearsign a message.

Peics Settings that affect encrypting

5c. Adding a new key

If there's a "PGP PUBLIC KEY BEGIN/END" block in the text, Peics will select the "Add Key" radio button. If you agree with this setting, then the key in the text will be added to the public keyring by PGP. Peics will pass the complete message to PGP. After running PGP there's nothing to do for Peics. PGP has showed already what it did.

Peics can also add the key from Eudora Pro's finger window. Use the EMSAPI interface to start the Peics dialog box. The window interface cannot find the finger window, so Empics cannot do this.

5d. Reply to coded mail

This is a very common usage, so I made it as easy as possible. Part of this is very similar to what is covered in section 5a. Decoding.

  1. Select "Message | Reply" (or push the Reply button) for a received encrypted mail.
  2. Select "Message | Run PGP..." (or push the key button).
    This will decode the mail after removing the '>'-signs. (See section 5a. Decoding).
  3. Back in Eudora you have the decoded text with the '>'-signs inserted.
  4. Now you can type your reply. When you are finished you can encrypt again. (See section 5b. Encrypting).

5e. Clearsign a message

If Peics cannot find an encrypted or signed message in an output window and you do not have a name in the "To:"-field, then it will select the "Sign" button. If you want to change to "Encrypt" or "Encrypt + Sign", please first click in the "Encrypt for" list box to get the full keyring.

If you check the "Sign From (-u)" check box, then Peics will add "-u userID" to the command-line. This is only necessary if you have more secret keys on your secret keyring. If the name field (following "Sign From (-u)") is empty, the "userID" is copied from the "From:" field in Eudora's output dialog box.

The "Sign from" parameter in "Peics settings..." is copied to the dialog box as the default setting. The "EncryptFor" parameter is copied to the name field.

Note: Before running PGP, Peics sends two menu commands to the message window: "Edit | Select All" and "Edit | Wrap Selection". This will insert carriage returns in the text. If this is not done now, Eudora will insert them just before sending the message and the signature will fail because the text has changed. Turn of the Wrap Text check box if you do not want the text to be wrapped. .

5f. Checking signatures

If Peics found a SIGNATURE BEGIN/END block it will select the "Check Sig" button from the 4 radio buttons. This will pass the block to PGP and insert the text that PGP returns. This makes it possible to check more signatures in one message. After the first text has been checked it is returned in the message but without the SIGNATURE BEGIN/END BLOCK. The next time you run PGP the next message will be checked and so on.
You must check the signature on PGP's output. Peics does not show anything.

5g. The "Edit | Undo"-function

If you have PGP'd and notice you have made an error, do not worry. The "Edit | Undo" menu selection restores the window text that appeared before PGP was started. As soon as you change anything in the text, you cannot undo the PGP action anymore, because the Undo function will undo the last change, as usual in Eudora. Note that "Edit | Undo" is disabled when you are not in the part of the window, where the text is. So if the cursor is in the subject-field, first move to the text and then choose Undo.
You cannot undo an Add-key action.

5h. The Skip button

You'll see a "skip" button in the dialog box, when Peics found an encrypted or signed text (5a, 5f). If you push it, Peics will move to the next PGP BEGIN/END block or to the next attached file. If it cannot find more of these, it will show a "Nothing to do" message.

Return to top

5i. The Password dialog box

If the KeepPassword option is on and Peics thinks PGP needs the pass word, then it presents this dialog box. You can type in a pass phrase edit box, which shows '*' characters and has better edit support than the PGP version. Peics keeps the pass phrase for you, so that you only have to type it once in an Eudora session. The pass phrase is a bit encrypted (with random data) after it has been passed to PGP and decrypted when it is needed again.

If you click the [Forget password] button in the "Run PGP..." dialog box, it will be cleared, so you have to type it again when needed. This is important when you use more secret keys or when you leave your computer while Eudora/Peics are still running. Note that you can see if Peics knows the pass phrase, because then the button is active (not greyed).

Peics(32) sets the pass phrase in its own environment. This should be passed to PGP, but it does not work if you use a .PIF file to run PGP.

Peics(16) passes the pass phrase on the command-line with the -z option, because WINOLDAP or WINOA386, the module that runs 16-bit DOS applications, copies the environment from the system, not from Eudora.

6. Settings dialog box (PEICS.INI configuration file)

You do not have to read this chapter unless you have special wishes. The default settings work fine for 80 % of the users, but the remaining 20% may wish to change Peics's configuration to suit their preferences. To change or review the configuration select the menu "Special | Message Plugins Settings..." and choose "Peics PGP-Eudora interface" from the plug-ins list.

Peics first reads the INI-file from the Windows directory, then from the Eudora directory and then from the directory, that's passed by Eudora. This is a usually a "Plugins" directory below the Eudora directory or below the mail directory, specified as command-line parameter for Eudora. The latter is usually used to give each user his own configuration.

Every time it reads an INI-file, it overrides the previous settings. This makes it easy to create a system-wide configuration and a user-specific configuration. I've included an INI-file with the default settings. If you agree with them you do not need the file because the program sets them internally before reading the first INI-file. You can check the settings in the Settings dialog box or by keeping the [CAPSLOCK] key down, while Peics is being loaded.

Here are the options that are currently supported (with their defaults):

[Settings]
In this section you can specify settings for Peics and its interface to Eudora. They are in the upper left group box "Peics settings" in the dialog box.
ChgToTempDir = 0
(Change dir to temp)
By default Peics specifies a full path to the file, that is to be handled by PGP. If you use the long "C:\WINDOWS\TEMP" name as your directory for temporary files (tempdir), then you may soon run out of command-line space.

If you check this option, then Peics will make the tempdir the current directory, so it only has to pass PEICS.ASC, instead of "C:\WINDOWS\TEMP\PEICS.ASC". If you do this, then check that PGP.EXE does not have its working directory specified to another directory, because then windows will change to that directory and PGP will not be able to find the file, that Peics made. You can check this in PGP.PIF (Win3.1) or in "File | Properties" for PGP.EXE in "My Computer".

UseToolbar = 1
(Not in the dialog box)
A click on the button on the right side of the toolbar should start the "Run PGP..." dialog. You can disable this feature by setting the value in PEICS.INI to 0. If you set it to -1, then the Window interface is not used at all. You can still use the EMSAPI interface, though. This can be handy for testing.
CopyToReadOnly = 1
(Not in the dialog box)
Normally (if set to 1), Peics will copy the decrypted text to a read-only window. If cleared (= 0), you are prompted were you want the text to go to (Clipboard or window), like in previous versions. Note that you can still "Select All" and "Copy" the text window to the clipboard. All operations that Eudora does (forward, save,..) are done on the original text.
AnsiOem = 0
(AnsiOem conversion)
If you turn this on, then Peics will do an AnsiToOem conversion before creating the file for PGP. After PGP has run it does an OemToAnsi conversion.

You may need this if you use special characters as in French, German, etc. Windows uses the Ansi character set, while DOS uses the Oem definition, so if you exchange mail with someone who does not use Windows (they exist!) and if you use those special characters, then you can try to turn on this option. Then PGP will maybe not complain about failing signatures and you can better read PGP's output. If you do not understand, what this is all about, leave it set to = 0.

ConvertAttach = 1
(Convert incoming attachments)
Decoding of incoming text attachments can be disabled by un-checking this option.
NickNames = 0
(Expand nicknames)
Normally Peics does only do a NickName expansion if you keep the shift key down while starting the "Run PGP" dialog box. If you set NickNames (=1), then nicknames will always be converted.
Return to top
[PGP Settings]
In this section you can specify settings for Pgp and its interface to Peics. These are in the group box "PGP settings" in the dialog box.
ProgPGP =
(PGP program)
Here you can specify a program that should be run instead of PGP.EXE or PGP.PIF. It will be searched in the same directories as PGP. In the dialog box you can push the "Browse" button to find the file. If you have Viacrypt's PGP, you can set its filename (optionally with path) here. (And do not forget to pay me if you use Peics commercially ;-).
PGPtempdir =
(PGP temp. dir)
You can set PGPtempdir to the directory where you want Peics to create and read the files that PGP will process. This overrides the value set in the environment variables TMP and TEMP. Normally it's better to change the TMP parameter in PGP's configuration file, because then PGP will use the same directory for its temporary files.
EncryptForSelf = 1
(Encrypt for self)
If you check this option, then Peics adds the name of the sender to the "Encrypt for"-field when it has to encrypt a message. This is good if you want to be able to read what you have encrypted.
EncryptFor =
(Encrypt for)
Normally Peics extracts the e-mail address of the sender from the "From:" field in the dialog box. This option overrides this, so the name you type here is used instead. The name is used for "Encrypt for self" and "Sign from" actions.
PGPPATH =
(Not in dialog box)
Here you can specify the directory where the PGP files (e.g.: PUBRING.PGP) are. This overrides the environmental variable PGPPATH.
KeepPassword = 0
(Keep password)
If you set this option (=1), then Peics will ask you for the pass word and pass it to PGP.
PasswordChar=
(Hide password)
Normally Peics does not show what you type as a pass word. Instead it shows '*' characters. Uncheck this item (or set it to 0) if you want Peics to show your pass phrase. If you set it to a non-zero value, this value is used instead of the '*' (=42) character. A '1' is translated to 42.
KeepOpen = -1
(Console (textmode) window for PGP)
The 32-bit version has a KeepOpen option. It affects the behaviour of the consolewindow in which PGP runs. It was necessary because I couldn't set this property for the 32-bit PGP.
These 3 radiobuttons you will see in the dialog box:
-1 ; handled by Windows
0  ; created by Peics; close yourself
1  ; created by Peics; close automatically
        when: 1) there are no errors
              2) PGP has to encrypt or sign
The values (-1, 0, 1) are used in the INI-file.

If you choose 0 or 1, you have to close the window by clicking on the console window or by pressing a key. The closebutton does not work in these cases.

KeepOpen does not work if you use a PGP.PIF file. If you set KeepOpen >= 0, then PEICS does not search for a PGP.PIF file unless you specify it explicitly in PEIC.INI.

ReadPubRing = 1
(Read public keyring)
Normally Peics tries to read your public key ring. Here you can turn this off. Then you get an edit box with the names to encrypt for instead of the list box.
Return to top
[PGPflags]
In this section you can specify default flags for Pgp. These options are in the "PGP flags" group box in the upper right corner of the dialog box.
AlwaysSign = 0
(Always sign)
If you check this option (1), then Peics will sign every message, that must be encrypted, with the first key on your secret keyring.
SignFrom = 0
(Sign from)
If you check this option, Peics will add a "-u userID" to the command-line for PGP. This tells PGP to use "userID" to find the secret key for signing. You will only need this if you have more than one secret key on your keyring.
Batchmode = 0
(Batchmode)
If you check this (1) then PGP does not complain so much and ask less. e.g. You'll not be prompted for another public keyfile, when PGP cannot find all keys. PGP will not ask for a pass phrase either so this will work only if you (can) set KeepPassword.
EyesOnly = 0
(Eyes only [-m])
If you never want to save the output of decoded text in your message, you might want to set this option. It will be copied to the "Run PGP..." dialog box.
[ModuleDefinition]
This section describes the loaded mailer module, that Peics found. The "FullModName" entry is used by Empics to start the program.
[SelectedModDefinition]
This section describes the module information, that Peics knows about. It is selected from the list when the loaded module does not exactly match any of the known modules. It has the same keys as the [ModuleDefinition] section.
Return to top

7. Miscellaneous

7a. Programversions and name change

The versionnumber of Peics increases by 0.01 on minor changes. Versions with new features get the next 0.x0 number. In this case the manual will be updated too. The timestamp always has the versionnumber. 1:25 means version 1.25.

Peics(32) is compiled for i486 and runs on both 80386 and 80486 (and better) processors. Peics(16) runs on a 80286 based computer too. Choose "Help | About Peics..." to get the "About Peics" dialog box. Here you can see which version you have (and who made this program ;-). It also shows your license information.

7b. Files in this distribution

In the file PeicsPro???.ZIP (??? = version number) you should find PEICS.ZIP and PEICS.SIG (the signature). In the file PEICS.ZIP you should find these files:
 Length   Size  Ratio   Date    Time  Name
 ------  ----- -----   ----    ----   --------
 160272  67178  59%  13-05-97  01:25  PEICS16.DLL    Peics(16)
 140320  70476  50%  13-05-97  01:25  PEICS32.DLL    Peics(32)
  53534  18995  65%  04-05-97  01:25  MANUAL.HTM     This manual
   5887   2472  59%  24-02-97  01:25  PEICS.INI      Configuration
    545    161  71%  24-02-97  01:25  PGP.PIF        PIF file for win3.1
   1896    941  51%  18-03-97  01:25  TODO.TXT       What to do now...
 ------ ------  ---                   -------
 362454 160223  56%                     6

In the file EMPICS.ZIP in the Empics distribution you should find these files:
 155664  64561  59%  03-05-97  01:24  EMPICS16.EXE   Empics(16)
  26144  12412  53%  25-04-97  01:24  EMPICS32.EXE   Empics(32) loader
 138784  68706  51%  04-05-97  01:24  MP32.DLL       Empics(32) program
  48548  17437  65%  04-05-97  01:24  MANUAL.HTM     This manual
   5887   2472  59%  24-02-97  01:24  PEICS.INI      Configuration
    545    161  71%  24-02-97  01:24  PGP.PIF        PIF file for win3.1
   1896    941  51%  18-03-97  01:24  TODO.TXT       What to do now...
   2562   1158  55%  26-04-97  01:24  REGISTER.DOC   Registration info
    591    362  39%  26-04-97  01:24  REGISTER.TXT   Registration form
 ------  ------ ---                   -------
 380621  168210 56%                     9

Empics(32) consists of 2 parts: an EXE-file (EMPICS32.EXE) and a DLL (MP32.DLL). This is the only way to do window subclassing between different processes in Win95. EMPICS32.EXE maps its DLL in Eudora's address space and the DLL does the actual interfacing. Direct interfacing between programs is not allowed.

The filesizes and dates in the actual ZIP-file may be a bit different, because I do not update this manual on every program update. You can use the file PEICS.SIG to check if you have the original files.
You need my public key (for pgpeudra@comerwell.xs4all.nl) for this.
You can get it:

Receiving the key by finger (Eudora Pro) or by mail is the easiest, if you have already installed Peics, because Peics can add the key to your public keyring.
To check the signature type at the DOS-commandline:

pgp peics.sig peics.zip

and PGP will show if the file has been changed. Of course this is no guarantee for the correctness of the program. It only shows that it's not corrupted. This is a good virusprotection too.

Every registered user (who wants this :-) will get an e-mail when I made a new version. You can regularly check the announce page to see if there are new versions announced. Of course I shall post in the new comp.security.pgp.announce newsgroup, when I have a new version.

7c. Useful links on the internet

This part will may be outdated soon, but you can use it as a starting point. If you need information about PGP or about other shells, you may find these links useful: The PGP-newsgroups:

7d. A brief history

For those interested, here's a brief history. Others read "Copyrights, licence & disclaimer". I first thought about writing this program when I saw someone struggling with both Eudora and PGP in spring '95. I looked for some PGP-shells, but couldn't find anything really convenient. It should be easier. The friend who worked with both programs learned to handle them and did not really need it anymore.
17th november 1995:
At 11 p.m. I decided to write the program. Now another friend had some real problems with this situation and worse, I got binhex- encoded files that were hard to decode on my Linux system. Of course this could be solved in any way, but now I thought it would be better to make life easier.
Version 0.12:
6th December: This was the first publicly available version after some testversions for friends only. It has just the basic features like encoding, decoding and adding a key. No special PGP-features like signing messages.
Version 0.13:
The previous version did not run with Eudora light 1.52, so I had to work again. Bad news for me, that QUALCOMM changed a lot. All windows' classnames have changed.
Version 0.14:
Added more relaxed name checking (-r option). Removed in version 0.22.
Version 0.15:
The "Edit | Undo"-function works with Eudora Light, too. And I added an extra check on the window where the text should go to after PGP has run. Someone reported that he got this text the wrong window.
Version 0.20:
+Clearsign text and check signatures
+Pass command-line options to Eudora
+Scan for key after decoding
+Choose where to copy decoded text (clipboard or window)
Version 0.26:
+Some bugfixes
+Better error reporting
Version 1.00:
+32-bit version
+button on toolbar
+handling of incoming attachments
+INI-file with some new options
Peics Light 1.14:
+EMSAPI on-request translator
+Sign from option
Peics Pro 1.20:
+Read and show public keyring
+Extended dialog box for selecting PGP options
+Batchmode
+Keep password

7e. Copyrights, licence & disclaimer

This is probably the most boring part of every manual, but it has to be, so here we go. Note that you should (still) read Empics instead of Peics, if you are using that program.

LEGAL ISSUES
============

In plain English:

  1. I do not promise that this software works. (But if you find any bugs, please let me know!)
  2. This program is NOT free software. You may not copy the program nor this license for others. (Versions below 1.00 (e.g. 0.26) are completely freeware, even for commercial use.)
  3. If you like to sell this program on its own or together with something else, please contact me, because I like money too ;-).
  4. You may not pretend that you wrote this software.
In legalese:

The author makes NO WARRANTY or representation, either express or implied, with respect to this software, its quality, accuracy, merchantability, or fitness for a particular purpose. This software is provided "AS IS", and you, its user, assume the entire risk as to its quality and accuracy.

Peics is copyright © 1995, 1996, 1997 Hans Bausewein, Hengelo, Nederland
All Rights Reserved except as specified below.

Permission is hereby granted to use, copy and distribute this program for non-commercial use, without fee, subject to these conditions:

  1. Permission for use of this software is granted only if the user accepts full responsibility for any undesirable consequences; the author accepts NO LIABILITY for damages of any kind.
  2. The copyright notes in this document or in the programs "About PEICS" dialog box are NOT changed, removed, hidden or made invisible in any way.
  3. Permission to make a copy of this license file and the program PEICS.DLL for back-up purposes or to use it on another machine, provided that no more than the number of users you paid for can use it at the same time.
NO WARRANTY

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

7f. Purchasing Peics Light/Pro

I do not sell the program. You can get it from the internet, yourself. This means, you can easily get the latest version. For me it saves a lot of time and administrative work. I like programming much more.

Instead I sell a license to use the program. This no-nonsense license offers you:

  1. Free updates/upgrades of every PGP-Eudora interface I publicly release within 1 year from the date of purchase of the license. If I change my distribution policy, you are sure you will get them without having to pay again. I do not guarantee, that I make those programs (although it's more probable, if I get paid well :-).
    I wrote "publicly release", because I'd like to have the option to make specialized software (e.g. for companies), that I cannot publish. Features for common use will be released publicly.
  2. Licenses can be used for both Empics and Peics. As noted in 1, you only have to pay me once.
  3. Permission to use those programs subject to the conditions in 7e.
  4. Permission to make as many copies as you like, provided that the number of running copies of the program do not exceed the number stated in the license.
  5. Registration on a mailinglist, that I maintain at my own Linux system. I cannot guarantee continuation of this mailinglist, but I shall try. Please go to the registration page for up-to-date information. If you intend to purchase the license, register yourself. If you use Eudora 2.2 or later, you can fill out a registration form in a dialog box, accessible from the "Register" button in the "About Peics..." dialog box.

    You will get an automatic reply within a few days and temporary try-out license. I shall send the permanent license when I got your payment.

Prices
A license for 1 copy for commercial use costs f50,- (Dutch guilders), which is (now) about $30. Every additional additional copy for the same company will cost f10,- extra. Please add costs for payment and 17.5 % VAT (Value Added Tax) if you are in the EU. Companies can get an invoice, which will save them the VAT. People outside the EU do not have to pay VAT. Instead they have to import the license, which could imply they have to pay local taxes. Contact me for site licenses that exceed 50 copies. Do not forget the e-mail address on the note for your registration. Otherwise I shall not know who paid.

Postbank number 7525347 or: ABN-AMRO number 60.96.29.298
Comerwell Software
Hengelo
The Netherlands
Note that this is not a postal address but a bank account. I also have a bank account in Germany and the USA (NY). See up-to-date information on my homepage.

Comerwell Software is registered at the Chamber of Trade (Kamer van Koophandel, KvK) Enschede at number 06072135. If Peics is bought for a registered company in the EU, you must send me a copy of the registration before I can send you an invoice.

7g. Remarks, comments, questions, etc

Remarks, comments, good ideas and mental support are very welcome. Maybe I may not reply immediately, subject to other work loads.

Please note this before you e-mail to me:

I would like to acknowledge Charles H. Tupper in Vancouver, Canada for his kind offer to undertake considerable time and effort to review and revise this Manual's English grammar to improve clarity and readability.

This Manual last revised - 97 - february 25


Hans (pgpeudra@comerwell.xs4all.nl)

Return to top