Translated manuals
Peics/Empic Pro 1.25 manual
- Introduction
- System requirements
- Installation
- How to start
- Using the program
- Settings dialog box (PEICS.INI configuration file)
- 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:
- The EMSAPI interface from the "Edit | Message plugins" menu.
- 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:
- Open the window where your text is.
- 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.
- 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.
- 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
- If you set "AlwaysSign" in
PEICS.INI Peics will select the "Encrypt + Sign" button instead of
"Encrypt".
- If you have checked the "Encrypt for self" option,
then the name of the sender (you:-) will also be added to this list.
This makes it easy to encrypt every message for your self (so that you can
at least read all mail encrypted by you ;-).
- If you keep the [Shift] key down while starting the dialog box, then the
nicknames in the "To:"- and "CC:"-fields will be expanded. If you check
"Nicknames" this will always be done.
- if "Read Public Keyring" is turned off, then Peics
will not show the list box with keys.
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.
- Select "Message | Reply" (or push the Reply button) for a received
encrypted mail.
- Select "Message | Run PGP..." (or push the key button).
This will decode the mail after removing the '>'-signs.
(See section 5a. Decoding).
- Back in Eudora you have the decoded text with the '>'-signs inserted.
- 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:
- From the keyservers
- From Comerwell's homepage
- By "Finger comerwel@xs4all.nl", but (AFAIK) Eudora Light cannot do this.
Eudora Pro can and Peics can add the key from Eudora's window to the keyring.
Use the EMSAPI interface to start the Peics dialog box. The window interface
cannot find the finger window.
- By mail from
comerwel@xs4all.nl. There's just a
"vacation" mailer, that sends a short information file with my key. Please type
subject "key", because I hope to make a real keymailer once again. Your message
will be ignored :-(, so you'd better not type any.
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:
- I do not promise that this software works. (But if you find any bugs,
please let me know!)
- 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.)
- If you like to sell this program on its own or together with something
else, please contact me, because I like money too ;-).
- 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:
- 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.
- 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.
- 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:
- 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.
- Licenses can be used for both Empics and Peics. As noted in 1, you only
have to pay me once.
- Permission to use those programs subject to the conditions in
7e.
- 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.
- 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:
- Send mail about this program to
pgpeudra@comerwell.xs4all.nl. I still like to find my personal mail ;-).
Besides it's easier to have all Peics mail together.
- If you have a question, please
read the FAQ
before sending mail to me. I do not like to answer the same questions all the time.
- The
bugs page
has information on bug reports and fixes.
- Don't forget to mention which version (16/32, Peics/Empics, Pro/Light)
you use and with which Eudora version.
- This program is not complete, yet. I think, I shall add some features in a future
version. This distribution comes with a file "TODO.TXT", that describes
some features, that I like to add. If you wish something, please first read this file.
However, I do not pretend to make a complete shell.
- I do not like to get large attached files by mail, because I have a slow
and expensive line to the internet.
- Please do not use the new "text/enriched" feature of Eudora, because my
Elm mailer does not understand those codes and it causes some problems for
pgp decoding.
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