What is Racs?
-------------

Racs is a simple bash script that stores and manages
your accounts. All the accounts are stored in a pgp/gpg
conventional encrypted file.
Depending on the account type, Racs is able to launch the 
appropriate client to log into the remote host.

License
-------

Copyright (C) 2002, Elisa Manara <e@entropika.net>
Racs is free software.  It is distributed under  the terms of
GNU General Public License, which may be found in the package.

Installing Racs
---------------

Run configure.sh
Copy racs script wherever you want in your PATH.
(For example to /usr/local/bin/racs)

Usage notes
-----------

Racs don't save the passphrase for decrypting the accounts
file. This means that for each operation you have to enter
the passphrase, either for crypting either for decrypting:
this is a little annoying, but more secure.

Racs fills with a '!' each empty fields in an account.
If a field required to login is empty, the account type is set
automatically to 'rem' (see Account Types).
Required fields are:

hostname
username

Requirements
------------

bash
expect
dialog (if you want to use the ncurses-based menu)
pgp/gpg

Racs was tested with:

bash version 2.05a.0(1)-release
expect version 5.32.2
cdialog version 0.9a
Xdialog version 2.0.5
wdialog version 0.5.3
whiptail version 0.21
pgp2.6.3i
pgp5i
gpg 1.0.6

Account file
------------

Racs stores all the accounts with the format

alias::hostname::username::password::account_type

within the racs.pgp file.
An example of  racs.pgp file is distributed with the package.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 The password for decrypting this racs.pgp file is "test".

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

In order to query Racs for a specific account, you have to
launch it with

racs <alias>

where <alias> is the short name used at insertion time.

Account types
-------------

Racs recognizes the following types of account:

ssh
ftp
telnet
mysql
sftp
web (http or ftp site authentication through a web browser)
rem

* rem
rem stays for 'reminder'.
When an account is defined as 'rem', no external program
is launched to connect to the remote host. Instead, all the
accounts data are wroten to standard output.

* web
When you set a 'web' account, the hostname for this account is
the complete URL of the site, username and password are those
required for site authentication.

Account Management
------------------

You can add, delete, modify an account either from the
ncurses-based menu, either by using the switches recognized by
Racs.

To access the ncurses menu:

racs -m

To add an account:

racs -a

To delete an account:

racs -r [alias]

If you don't specify an alias on the command line, Racs will ask
you for it at right time.

To modify an account:

racs -e [alias]

To list all the accounts:

racs -l

To change the pgp/gpg passphrase for racs.pgp file:

racs -c

Importing accounts from a file
------------------------------

Racs is able to import accounts from a plain text file.
Account fields must follow this order:

alias hostname username password account_type

racs -i [filepath] [separator]

Examples:

	racs -i /tmp/my_file tab

	Extracts tab separated fields from file /tmp/my_file.

	racs -i /tmp/my_file space

	Extracts space separated fields from file /tmp/my_file.

	racs -i /tmp/my_file "/"

	Extracts fields separated by "/" from file /tmp/my_file.

Warning: an account line cannot contain empty fields. You have to
fill empty fields with a '!'.

TODO
----

Allowing the user to specify some options for each account.
For example, somebody would specify some switch for ssh, or
make an ftp connection with passive mode...

CREDITS
-------

Thanks to Wrestler <wrestler@tiscalinet.it> for adding sftp support.

FEEDBACKS
---------

For problems, bug reports or suggestions, feel free to contact

Elisa Manara <e@entropika.net>