                              
                                            
                                               
                                             
                                              
                                             
                                  


Version: 3.02
Date: 5 July 1998
Author: Jos Santos <jcsantos@iname.com>


 This file contains very useful information about Codigo Pro 3.When you have
a doubt check this file first or send me an e-mail.

  Sorry in advance for some typing or grammatical errors but I'm not American,
I'm Portuguese doing my best to translate this manual into English.



                  OFFICIAL DOCUMENTATION OF CODIGO PRO 3.02

                                 Index

                 1. Introduction to Codigo Pro
                 2. Working with Codigo Pro
                     2.1 Installation
                     2.2 How to use Codigo Pro
                           2.2.1 Modes
                           2.2.2 Options
                           2.2.3 Errorlevels (for batch files)
                           2.2.4 Examples
                     2.3 Advises
                 3. Answer to common question
                 4. Security
                 5. Copyright and Warranty
                 6. Shareware notes and Updates
                 7. How to register Codigo Pro
                 8. Thanks



1. Introduction to Codigo Pro
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Codigo Pro is a file encryptor which means that, with a password, all the
files you select will be encrypted.Crypt means "codify" thru an algorithm
(mathematical formula) something, in this case, the bytes of a file.
  What's the utility of such a program you may ask.Well, in our days at
which more all kind of information is stored in informatic devices, it's
necessary to guarantee the right to privacy of your information.It can be
of any type, since simple texts to complete projects.
  Thinking on this I developed Codigo Pro.



2. Working with Codigo Pro
~~~~~~~~~~~~~~~~~~~~~~~~~~

  In this chapter I'll try to explain how Codigo Pro works.Remember the
name of the chapters and read those you may need more.
If this is the first time you are reading this file, I recommend that you
give a first look at the program and then read the following chapters.

 
      2.1 Installation
      ~~~~~~~~~~~~~~~~

      It's really very simple.The file codigo.exe is a standalone program
      and you won't need anything else.I strongly recommend you to copy
      codigo.exe to a directory in your path.Type path and [ENTER] and see
      which directories are in your path.In 99.9% of the cases the
      C:\WINDOWS (or C:\DOS) is, you'll just have to copy the exe for
      that place or create a directory for Codigo (eg: C:\CODIGO) and then
      put the directory into the path (append to the last line of autoexec.bat
      this: path=c:\codigo;%path%).
      By the way, don't forget to copy this file too!


      2.2 How to use Codigo Pro
      ~~~~~~~~~~~~~~~~~~~~~~~~~

      In the next four subchapters I'll describe the modes and the several
      options you which are available in this version of Codigo.


          2.2.1 Modes
          ~~~~~~~~~~~

          Codigo Pro has three work modes.Mode E, D and V.
          Mode E is for encryption.When you want to encrypt files use this
          mode.You have also a very powerful option to use with this mode.
          It's /N with it Codigo will also encrypt the filenames.
          Mode D is for decryption.When you want to decrypt files use this
          mode.As with mode E, pay attention to the options.
          Mode V is to view the file status of the files you selected.It'll
          show whether the files are encrypted or not.It'll also tell you
          what's the minimal version of Codigo Pro to decrypt those files.


          2.2.2 Options
          ~~~~~~~~~~~~~

          Codigo Pro has six options to complement with the modes.
          The six options are:


          /I

              - disables the integrity test that Codigo always does when
            it initializes a work session.This integrity test is very
            important to detect possible virus or changes in the program.
            For all that it's not recommended that you use this options.You
            should only use it as a last chance to keep working with Codigo
            until you can restore it from the package.


          /N

              - is very powerful, it's used to encrypt the filenames (not
            their data).It can only be used with mode E (obviously).When a
            filename is crypted, it's original name is kept in the header.


          /D

              - allows that the crypted files maintain the date/time stamp
            they had.By default Codigo Pro crypts the date of the files as an
            additional protecting measure and to make it easier to recognize
            the crypted files (they always have the date of 1-1-80 X:XX) where
            X:XX is the version of Codigo Pro, in this case, 3.02.
            If you don't want date to be encrypted use option /D.This option
            also can only be used for encryption.(Obviously too)


          /R

              - keeps the current filename not caring with the name stored
            in the Header.
            This option can be useful if after you crypt the a file you have
            renamed it and you want to keep that name.When used on files
            crypted with the option /N ,the filenames will be lost and you'll
            have files with names like TAGEIKPN.CP3


          /S

              - tell Codigo Pro to make no noise.It has no other purpose
            besides that.


          /P:xxxxx

              - where xxxxx is the password, allows defining a password in
            the command line.
            The password cannot have spaces and in the Shareware version it's
            restricted to 5 chars.Another way to enter the password (and the
            most recommended) is to let Codigo ask you the password (you just
            don't have to type any password in the prompt).In this way you
            can use spaces and other special characters.The password will be
            hidden with *.


          2.2.3 Errorlevels
          ~~~~~~~~~~~~~~~~~

          Errorlevels are useful to control the execution of a program
          within other or thru batch files.Thinking on that Codigo Pro
          has errorlevels nearly everything that may happen.
          The current errorlevels are:

          0- All OK
          1- Codigo help menu
          2- There's not disk space left
          3- There's not enough RAM
          4- Invalid mode
          5- It has specified a PASSWORD with option V too.
          6- There are no files corresponding to the user criteria.
          7- Too many files.
          8- The computer is not at least a 386.
          9- Codigo is already registered (with option /regist)
          10- Invalid command line
          11- Integrity test failed
          12- Not enough chars in the password
          13- Too many chars in the password
          14- Disk is write-protected
          15- Exit to the operating system
          16- Invalid register code
          17- Codigo successfully registered
          18- Password doesn't match

          Don't forget that in batch files errorlevels have to be checked in
          decrescent order.


          2.2.4 Examples
          ~~~~~~~~~~~~~~

          After all this "theory" nothing is better than a few examples to
          clarify things.

          codigo *.* e /n /p:54321

          This command will crypt all the files in the current directory
          and their filenames (because of the /N option) with the password
          54321

          codigo *.txt e /s /d /p:09876

          This command will crypt all files with extension .txt in the
          current directory, it won't encrypt dates (because of option
          /D) nor it'll play any sounds, the password 09876 is used

          codigo t*.?xe e

          This command will crypt all the files in the current directory
          which start with an 't' for which the last 2 letters of the
          extension are 'xe', and it'll ask the user to input the password.

          codigo *.doc d /r

          You'll have the opportunity to enter the password to decrypt all
          *.doc files and they'll keep their current filenames (because of
          /R option)

          codigo *.* d /p:12345

          This command will decrypt all the files of the current directory
          with the password 12345

          codigo *.txt d /s /i

          This command will decrypt all files with extension .txt in the
          current directory, sounds are disabled, it'll disable the
          integrity test and Codigo will prompt user to enter the
          password

          codigo c:\windows\. v

          This command will show the file status of all the files in the
          directory c:\windows


      2.3 Advises
      ~~~~~~~~~~~

      I'll tell you some advises and hints on how to get better performance
      with Codigo Pro.

      Dos Real Mode-

       Use SMARTDRV to create disk cache, even if it's just 256K, you'll
      notice a great improvement in speed.

      Windows-

       Open a DOS window and run Codigo.In this case do NOT use smartdrv
      (it would just stole memory) ,windows automatically creats cache.

      General-

       Have CODIGO PRO always in the PATH (ex:C:\WINDOWS).Read chapter 2.1
      Installation.
       Avoid using Codigo Pro directly from a floppy disk because all the things
      will run slower.If possible, encrypt the files first on the hardk disk
      and then copy or move them to the floppy disk.
       Codigo is much faster encrypting big files but few than small files
      but many.Every time it's possible,compact to one file an whole directory
      and then encrypt it.Don't do the opposite.



3. Answers to common questions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 In this chapter I'll try to answer in an object way questions that many
users do to me or doubts that could appear.Nothing better than read this
questions, some of this doubts can be your doubts, too.


 Q: I'm encrypting/decrypting/viewing an whole directory, is there any way
to make Codigo stop ?

 A: Of course, you'll just have to press Esc and Codigo will stop immediately
without loosing the work it did.


 Q: Why can't Codigo encrypt some files ?

 A: Codigo Pro 3 just doesn't encrypt files that have system, read-only, or
hidden attributes.I decided not to do this for safety reasons and because
problems could rise with that (versions 2.XX of Codigo had problems with
that).Anyway, if you really need to crypt one of those files, all you have
to do is to change the attribute just to archive and then use Codigo.


 Q: Codigo tells me that the command line is invalid.What should I do ?

 A: Look at the options you choose and verify the modes.Probably the options
aren't compatible with the modes or you changed the order of the parameters.
Although the order of the options doesn't matter, it's necessary that the
first parameter is the name of the file, the second parameter the mode
(E,D or V) and after that, you can put the options in the order you want.


 Q: Codigo tells me that it has been changed.Is this serious ? What do I do ?

 A: Well, as you can read in the warning, there are only two causes for this,
a virus or then someone changed the executable.What you should do is, as
soon as possible, restore the file codigo.exe from the zip package.Unzip the
file cod302e.zip.


 Q: I want to use passwords larger than 5 chars.How can I do that ?

 A: With the Shareware version you can't.You have to register Codigo.First
read the chapter 'How to register Codigo Pro'.But resuming, you just have
to get in contact with the author, accord a way of paymment, and it'll be
given your persornal registery code that allows immediatelly your Shareware
copy to become a registered version.You'll be free of the shareware messages
and of the 5 chars limit.


 Q: I want to register Codigo Pro.When will I get the registered version?

 A: Immediately.You only need your register keyword.Then you type
codigo /regist ,you put your name and the respective keyword and you'll
be able to use Codigo Pro without any limitation.


 Q: I have a question that's not stated here.What should I do ?
  
 A: Send me an e-mail to jcsantos@iname.com and explain your doubt,I'll
answer as soon as possible.If your question is pertinent I may put it here
to clarify it.



4. Security
~~~~~~~~~~~

 The safety of your data encrypted with Codigo depends, in good part, in
the choose and in the size of the password.As harder (more different chars)
and as bigger is the password more difficulty will have a hacker to crack it.
Try to use password from 8 to 14 characters (that way it'll be impossible
to anyone in the world to crack it in real time).The Shareware version is
limited to 5 chars for safety reasons.If you want more than that please
read the answer to the question in chapter 3.
 When you type your password be aware that it's totally different 'SECRET',
'secret' or 'Secret'.For Codigo those are different passwords.Codigo
is case sensitive in the password.
 CODIGO does his best for the safety of your information because of that
it makes impossible to recover a file after it has been encrypted.Don't get
scared now.I'll show you an example of this:
You have the file WORK.TXT.To encrypt it you write 'codigo work.txt e
Very_Secret'.The result will be a file named work.txt with a few bytes more
and all encrypted.(that after you may decrypt).

 The question is: Where's the original file ?

 Many other encryptors just erase the original file and with a simple
undelete it's possible to recover it.With Codigo Pro it's different.Codigo
does a WIPE to the original file which makes it impossible to any data
recovery to see just a single byte of the file before it was crypted.



5. Copyright e Warranty
~~~~~~~~~~~~~~~~~~~~~~~

  The name Codigo Pro 3 and the algorithm used are property of Jos Santos.

   You are using Codigo Pro 3 at your own risk! I, Jos Santos, am NOT
 responsable for any kind of damage caused directly or indirectly by the
 use or misuse of Codigo Pro 3.Using Codigo Pro 3 you are accepting this
 rules.

  Don't get scared with this phrases, all the programs says them and this
is the way things work.That doesn't mean you shouldn't have some care.But
just to let you know, Codigo has been under several tests on several
computers before it was published.



6. Shareware Notes and Updates
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  This program is Shareware, after a trial period of 20 days you are
encouraged to register Codigo Pro for only US 15$00.Registerd users
won't have password limits nor the boring shareware messages, besides that
they'll get a discount for Codigo Pro 98.
  You are encouraged to distribute file cod302e.zip, unchanged, to your
friends, in BBS or in CD-ROMS.
  Updates to Codigo Pro 3 and Codigo Pro 98 (when it's finished) will be
availabel in the Official Homepage of Codigo Pro on the internet at
http://codpro.home.ml.org (or http://www.terravista.pt/nazare/1391)



7. How to register Codigo Pro
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  To register Codigo Pro you'll have to enter in contact with me thru the
e-mail jcsantos@iname.com so we may combine a way of payment.I'm at this
momment studying other forms of payment directly in the net or thru
bank tranferences.Maybe I can offer them soon.For now you'll have to
contact me and tell me in what name you want to register Codigo Pro.
Codigo Pro costs just US $15.00 a small price to all the work it gave me.

  To have access to the register menu of Codigo Pro type 'codigo /regist'.
You'll be asked to enter your name and your personal register code.That code
is unique for each name, to get your code, contact me.



8. Thanks
~~~~~~~~~

  I have to thank several persons.One of them is Markus Hahn, a fellow and
also a programmer with whom I changed ideas, opinions and experiences.Other
person that is helping me distributing and spreading Codigo Pro is Vasco
Vilaa and deserves a reference here.I can't forget to thank a teacher of
mine, Paulo Boua, which thaught me how to structurate my programming and
corrected many of my common errors.Thanks to him too I was able to improve
my programming skills.
  I also have to thank all the people that use Codigo Pro but specially
to the registered users that support the development of this program.



Jos Santos <jcsantos@iname.com>
