ftfs(1C)                    FTAM 3.00                    ftfs(1C)



     NAME
          ftfs - insert an entry in an FTAM filestore database

     SYNOPSIS
          ftfs [ [ -i ] filestore-db-entry ]

     DESCRIPTION
          Ftfs allows you to keep a list of initiator identities and
          encrypted passwords for frequently used filestores.  When
          you include a filestore in an FTAM file specification and
          you do not give an initiator identity and password on the
          command line, FTAM for AViiON Systems resolves them by
          searching the .ftamdb file in the your home directory.  It
          takes the initiator identity and password from the first
          entry in the database with a matching filestore name.

          An alias facility is also provided.  If you frequently
          access a filestore with different sets of initiator
          identities and passwords, you can use an alias for each set
          of filestore, initiator identity, and password.  FTAM for
          AViiON Systems will resolve an alias given as a filestore
          name to a real filestore name, initiator identity, and
          password.

          If you invoke ftfs without arguments, you will be prompted
          for an optional alias, filestore name, initiator identity,
          and password.

          The format of a filestore-db-entry is

             [alias@]filestore[#initiator-identity[#password]]

          where braces, [ ], indicate optional fields. If you do not
          specify a field but you include the -i option, you will be
          prompted for the field value, otherwise the field is set to
          null.


          FTAM for AViiON Systems commands consult .ftamdb to resolve
          initiator identities and passwords when they are not given
          on the command line.  .ftamdb is searched sequentially:  for
          each entry, the given filestore name is compared first to
          the alias field and then to the filestore field.  If a match
          occurs on either field, the initiator identity and password
          are resolved from the matching entry and the search halts.


          An entry in .ftamdb is a line of text that can be edited
          directly with a text editor.  Except for the password field,
          you can modifiy and delete lines in the database.  The
          password is encrypted with a key that includes user specific
          data.  If an entry is copied to the .ftamdb file of another



     Licensed material--property of copyright holder(s)         Page 1

     ftfs(1C)                    FTAM 3.00                    ftfs(1C)



          user, the filestore password will not be decrypted
          correctly.  The permissions for .ftamdb must be set so only
          the owner can read or write the file (DG/UX mode 0600).
          Ftfs inserts entries at the beginning of the file.



     EXAMPLES
          The following sequence of examples illustrates the function
          of ftfs and $HOME/.ftamdb.


          1 % rm $HOME/.ftamdb

          Delete the filestore database.


          2 % ftrattr fs#foo.c

          Since no filestore database exists, access the fs filestore
          with the initiator identity and password set to NULL.


          3 % ftfs fs#initid#passwd

          Create a new filestore database since one does not currently
          exist.  Add an entry for filestore fs with corresponding
          initiator identity set to initid, and password set to
          passwd.


          4 % ftrattr fs#foo.c

          Search the filestore database for the filestore fs to obtain
          an initiator identity and password for use with the ftrattr
          command.  The initiator finds the fs entry added in the
          previous example and sets the initiator identity to initid
          and password to passwd for the command.


          5 % ftrattr fs#foo.c##

          Do not search the filestore database since the file
          specification is fully qualified.  The initiator sets the
          initiator identity and password to NULL for the command.


          6 % ftfs a@fs#init1#pass1

          Insert an entry for filestore fs with alias a, initiator
          identity init1, and password pass1 in the filestore
          database.



     Licensed material--property of copyright holder(s)         Page 2

     ftfs(1C)                    FTAM 3.00                    ftfs(1C)



          7 % ftfs b@fs#init2#pass2

          Insert an entry for filestore fs with alias b, initiator
          identity init2, and password pass2 in the filestore
          database.


          8 % ftrattr b#foo.c

          Search the filestore database for b to obtain an initiator
          identity and password for use with the ftrattr command.  The
          initiator sets the filestore to fs, initiator identity to
          init2, and password to pass2 for the command.


          9 % cat $HOME/.ftamdb
          b@fs#init2#4tDLqw01
          a@fs#init1#1rLs341
          fs#initid#6iLqwFro

          Print the current contents of the filestore database.


          10 % ftrattr fs#foo.c

          Search the filestore database for fs to obtain an initiator
          identity and password for use with the ftrattr command.  The
          first entry matches.  Set the filestore to fs, initiator
          identity to init2, and password to pass2.


     FILES
          $HOME/.ftamdb

     SEE ALSO
          ftam(1C), ftcattr(1C), ftcp(1C), ftls(1C), ftmv(1C),
          ftrattr(1C), ftrm(1C).
          "Using FTAM for AViiON(R) Systems".

















     Licensed material--property of copyright holder(s)         Page 3