*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> db_load (8)              



NAME    [Toc]    [Back]

       db_load  -  Loads  standard  input  to  a  database  files
       (Enhanced Security)

SYNOPSIS    [Toc]    [Back]

       /usr/tcb/bin/db_load [-nT] [-c name=value] [-f  file]  [-h
       home] [-t btree | hash | recno] db_file

OPTIONS    [Toc]    [Back]

       Specify  configuration  options  for the DB_INFO structure
       provided to db_open ignoring any value they may have  been
       based on the input. The command-line format is name=value.

              The following keywords are supported:  The  minimum
              number  of keys per page.  The byte order for integers
 in the stored database metadata.  The size  of
              pages  used  for  nodes in the tree, in bytes.  The
              value of the DB_DUP flag.  The density  within  the
              hash  table.   The size of the hash table.  Specify
              fixed-length  records  of  the  specified   length.
              Specify the fixed-length record pad character.  The
              value of the DB_RECNUM  flag.   The  value  of  the
              DB_RENUMBER  flag. The parenthetical listing specifies
 how the value part of the name=value  pair  is
              interpreted. Items listed as (boolean) expect value
              to be 1 (set) or 0 (unset). Items listed  as  (number)
  convert  value  to  a number. Items listed as
              (string) use  the  characters  of  value  directly.
              Read from the specified input file, instead of from
              the standard input.  Specify a home  directory  for
              the  database.  The  correct directory for enhanced
              security  is  /var/tcb/files.   Do  not   overwrite
              existing  keys in the database when loading into an
              already existing database. If a key/data pair  cannot
  be loaded into the database for this reason, a
              warning message is displayed on the standard  error
              output  and  the key/data pair are skipped.  The -T
              option allows non-Berkeley DB applications to  easily
 load text files into databases.

              If  the  database to be created is of type btree or
              hash, the input must be paired lines of text, where
              the first line of the pair is the key item, and the
              second line of the pair is its  corresponding  data
              item.  If  the  database  to  be created is of type
              recno, the input must be lines of text, where  each
              line is a new data item for the database.

              A  simple escape mechanism, where newline and backslash
 (\) characters are special, is applied to the
              text  input.  Newline characters are interpreted as
              record separators. Backslash characters in the text
              will  be  interpreted  in  one  of two ways: If the
              backslash  character  precedes  another   backslash
              character,  the  pair will be interpreted as a literal
 backslash. If the backslash character precedes
              any  other  character, the two characters following
              the backslash will be  interpreted  as  hexadecimal
              specification  of  a single character, that is, \0a
              is a newline character in the ASCII character  set.

              For  this  reason, any backslash or newline characters
 that naturally occur in the text input must be
              escaped to avoid misinterpretation by db_load.

              If  the  -T  option  is  specified,  the underlying
              access method type must be specified using  the  -t
              option.  Specifies the underlying access method. If
              no -t option is specified,  the  database  will  be
              loaded  into  a  database  of  the same type as was
              dumped, that is, a hash database is  created  if  a
              hash database was dumped.

              The  btree and hash databases may be converted from
              one to the other. The recno databases  may  not  be
              converted  to  any  other database type or from any
              other database type.

DESCRIPTION    [Toc]    [Back]

       A customized version of the  Berkeley  Database  (Berkeley
       DB)  is  embedded in the operating system to provide highperformance
 database support for critical security  files.
       The  DB  includes  full transactional support and database
       recovery, using write-ahead logging and  checkpointing  to
       record changes.

       The  db_load  utility  reads  from  the standard input and
       loads it into the db_file database . The database  db_file
       is created if it does not already exist.

       The  input  to db_load must be in the output format specified
 by the db_dump utility or as  specified  for  the  -T

       The db_load utility utility attaches to one or more of the
       Berkeley DB shared  memory  regions.  In  order  to  avoid
       region corruption, it should always be given the chance to
       detach and exit gracefully. To cause db_load to  clean  up
       after  itself  and exit, send it an interrupt signal (SIGINT).

       The db_load utility can be used to load  text  files  into
       the security databases. It is used by Tru64 UNIX utilities
       and is not recommended for use by  system  administration.
       The  edauth  utility provides a supported means of loading
       records correctly into the security databases.

RETURN VALUES    [Toc]    [Back]

       The db_load utility exits 0 on success, and >0 if  one  or
       more  key/data  pairs  were  not  loaded into the database
       because the key already existed, and with >1 if  an  error


       If  the  -h  option  is  not specified and the environment
       variable DB_HOME is set, it is used as  the  path  of  the
       database   home.   The  home  directory  for  security  is

FILES    [Toc]    [Back]



SEE ALSO    [Toc]    [Back]

       Files: authcap(4)

       Commands: edauth(8), db_dump(8)

[ Back ]
 Similar pages
Name OS Title
db_archive Tru64 displays security database log files no longer involved in active transactions (Enhanced Security)
db_stat Tru64 Displays statistics for the database files (Enhanced Security)
tee Linux read from standard input and write to standard output and files
db_checkpoint Tru64 Periodically checkpoint the security database log (Enhanced Security)
db_printlog Tru64 Displays database log file (Enhanced Security)
files Tru64 File control database (Enhanced Security)
ttys Tru64 Terminal control database file (Enhanced Security)
prpwd Tru64 Protected password authentication database (Enhanced Security)
default Tru64 System default database file (Enhanced Security)
db_recover Tru64 Restores the database to a consistent state (Enhanced Security)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service