


NSRINFO(8)                                             NSRINFO(8)


NNAAMMEE
       nsrinfo - NetWorker file index reporting command

SSYYNNOOPPSSIISS
       nnssrriinnffoo  [  --vvVV ] [ --ss _s_e_r_v_e_r | --LL ] [ --nn _n_a_m_e_s_p_a_c_e ] [ --NN
       _f_i_l_e_n_a_m_e ] [ --tt _t_i_m_e ] [ --XX _a_p_p_l_i_c_a_t_i_o_n ] _c_l_i_e_n_t

DDEESSCCRRIIPPTTIIOONN
       The nnssrriinnffoo command generates reports about  the  contents
       of a client file index.  Given a required NetWorker client
       name and no options, nnssrriinnffoo will produce a report of  all
       files  and objects, one per line, in the _b_a_c_k_u_p name space
       for that client.  It can also generate reports for a  spe-
       cific  file index name space, for all name spaces at once,
       for a particular XBSA application, and can  be  restricted
       to  a single time (the time at which the entry was entered
       into the file index, called the _s_a_v_e_t_i_m_e).

       For example, to generate a report of all files  backed  up
       in  the most recent backup of the _/_u_s_r file system for the
       client  _m_a_r_s,  use  the  following  sequence  of  commands
       (assuming the %% character below is the shell prompt):
              %% mmmmiinnffoo --rr nnssaavveettiimmee --vv --NN //uussrr --cc ppeeggaassuuss --oott || ttaaiill --11
              880099775533775544
              %% nnssrriinnffoo --tt 880099775533775544 mmaarrss
       Note:  The  time  used in the query is obtained by running
       the mmmmiinnffoo(8) command with a custom report  to  print  the
       save time for the most recent save set for _/_u_s_r_.  The time
       printed is passed to nnssrriinnffoo along with the  name  of  the
       client (mars).

       Unless  you  use  the --LL option (see below), you must have
       NetWorker Administrator privilege to use this command.  In
       the  case  of --LL, you must be a system administrator (i.e.
       root on a Unix system).

OOPPTTIIOONNSS
       --vv     Verbose mode.  In addition to the  file  name,  the
              type of the file (see below for more information on
              file types), the internal file index identifier (if
              any),  the  size  (if  it  is a Unix file), and the
              savetime are printed.  This option may be  combined
              with the --VV option described below.

       --VV     Alternate  verbose  mode.   In addition to the file
              name, the offset within the save set containing the
              file, the size within the save set, the application
              namespace (see the --nn option below for  a  list  of
              values),  and  the  savetime,  are  printed.   This
              option may be combined with the --vv option described
              above.

       --ss _s_e_r_v_e_r
              The name of the NetWorker system to be queried.  By



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





NSRINFO(8)                                             NSRINFO(8)


              default, the server on the local system is queried.

       --LL     Open  a  file  index  directly  without  using  the
              server.  This option is used for debugging,  or  to
              query  the  file  index while NetWorker is not run-
              ning.

       --nn _n_a_m_e_s_p_a_c_e
              The file index name space to query.  By default the
              _b_a_c_k_u_p  name  space  is used.  The other recognized
              values are: _m_i_g_r_a_t_e_d, _a_r_c_h_i_v_e (reserved for  future
              use),   _n_s_r   (for  internal  use),  _i_n_f_o_r_m_i_x  (for
              informix data), and _a_l_l.

       --NN _f_i_l_e_n_a_m_e
              An exact filename to look for in  the  file  index.
              Only  index entries matching this name exactly will
              be printed.  Note that for some  clients,  such  as
              NetWare, the name stored in the file index is often
              not made up of printable ASCII  characters,  giving
              this option limited use.

       --tt _t_i_m_e
              Restricts  the query to a single, exact, save time.
              The time can be in any of  the  NetWorker  nnssrr__ggeett--
              ddaattee(3)  formats.   Every  save set created by Net-
              Worker has a unique save time; these times  can  be
              determined by using the mmmmiinnffoo(8) command.

       --XX _a_p_p_l_i_c_a_t_i_o_n
              Restricts  the query to list information for only a
              specific X/Open Backup Services (XBSA) application.
              Valid  application  types  are  AAllll,,  IInnffoorrmmiixx,, and
              NNoonnee..  The application type is not case  sensitive.
              See APPLICATION TYPES, below, for more information.

FFIILLEE TTYYPPEESS
       The file index can store entries for all types of clients.
       Each index entry includes an index entry type to differen-
       tiate between the types of entries.  In general, only  the
       client that created the index entry will be able to decode
       the entry.

       Index entry types recognized by nnssrriinnffoo are listed  below.
       However,  even  though these types are recognized, nnssrriinnffoo
       can only completely decode one entry type: the  Unix  ver-
       sion  decodes Unix entry types, and the NT version decodes
       NT entry types.  For other recognized types, some informa-
       tion may be incomplete.

       old UNIX         Clients  running  pre-NetWorker  3.0  for
                        Unix.

       UNIX             Clients  running  pre-NetWorker  4.0  for



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2





NSRINFO(8)                                             NSRINFO(8)


                        Unix.

       UNIX ASDF        Index   entries  including  extended  ASM
                        Structured Data Format (ASDF) information
                        for  clients  running  NetWorker  4.1 and
                        above for Unix.

       UNIX ASDF v2     Index entries from  agentless  saves  for
                        clients  running  NetWorker 4.2 and above
                        for Unix.

       UNIX ASDF v3     Index entries for large files (files >  2
                        gigabytes)  for clients running NetWorker
                        5.1 for Unix and beyond.

       old DOS          DOS clients running pre-NetWorker for DOS
                        2.0.

       DOS              DOS, Windows or OS/2 clients running ver-
                        sion 2.0 of NetWorker for DOS, Windows or
                        OS/2.

       DOS old ASDF     DOS, Windows or OS/2 clients running ver-
                        sion 2.0 of NetWorker for DOS, Windows or
                        OS/2.

       WIN ASDF         Windows  or  NT clients running NetWorker
                        for Windows NT 4.2 and above.

       WIN ASDF v2      Windows or NT clients  running  NetWorker
                        for Windows NT 4.2 and beyond, created by
                        using agentless saves.

       old NetWare      NetWare clients running pre-NetWorker for
                        NetWare 3.0.

       NetWare          NetWare  clients  running  NetWorker  for
                        NetWare 3.0 and above.

       OSF 64bit        A client running OSF/1  with  64bit  file
                        sizes and offsets.

       continuation     A  special,  internal index entry, gener-
                        ated when a file crosses save set  bound-
                        aries in a save set series.

AAPPPPLLIICCAATTIIOONN TTYYPPEESS
       All              This  application  type prints out all of
                        the X/Open  Backup  Services  API  (XBSA)
                        information  available  for  each object;
                        only XBSA objects are  printed.   The  -v
                        and -V flags have the same effect here as
                        they do on files.




NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        3





NSRINFO(8)                                             NSRINFO(8)


       Informix         This application  type  prints  out  only
                        those   objects  recognized  as  Informix
                        Database objects (XBSA ObjectOwner.bsaOb-
                        jectOwner   is  INFORMIX).  The  -v  flag
                        behaves as it does with files, while  the
                        -V  flag prints out all the XBSA informa-
                        tion about the object (see  All,  above),
                        including the normal -V information.

       None             This  application type prints out objects
                        that are _n_o_t XBSA objects, but match  the
                        given criteria.  For example, this option
                        can be used to  print  a  list  of  files
                        backed up from a client.

FFIILLEESS
       //nnssrr//iinnddeexx//_c_l_i_e_n_t//ddbb

SSEEEE AALLSSOO
       nnssrr__ggeettddaattee(3), mmmmiinnffoo(8), nnssrrcckk(8), nnssrriinnddeexxdd(8).

DDIIAAGGNNOOSSTTIICCSS
       bbaadd ttiimmee vvaalluuee ``_t_i_m_e''
              The time value specified in the --tt option is not in
              a valid nnssrr__ggeettddaattee(3) format.

       ccaannnnoott ooppeenn iinnddeexx ffoorr cclliieenntt _c_l_i_e_n_t:: _r_e_a_s_o_n
              The file could not be opened using the  --LL  option.
              The  specific reason is printed, although there may
              be several.  The most likely reasons are _p_e_r_m_i_s_s_i_o_n
              _d_e_n_i_e_d  if  the user is not the superuser, and _s_e_r_-
              _v_i_c_e _b_u_s_y_, _t_r_y _a_g_a_i_n if the file index  is  already
              locked (by nnssrriinnddeexxdd(8),ffoorrexample).

       ccaannnnoott ccrreeaattee ddbb ssccaann oonn _c_l_i_e_n_t
              An  internal  error  occurred  while  attempting to
              query the file  index.   Contact  Legato  Technical
              Support.

       _n_u_m_b_e_r bbaadd rreeccoorrddss ffoorr cclliieenntt _c_l_i_e_n_t
              This  diagnostic  is printed at the end of a report
              if any bad index records were detected.  This is  a
              sign  that the index is damaged, and may need to be
              recovered.

       ccaannnnoott ccoonnnneecctt ttoo sseerrvveerr _s_e_r_v_e_r
              The index server is not available for one  of  many
              reasons.   For example, the NetWorker server may be
              down, or nnssrriinnffoo may not be able to  connect  to  a
              running  server  due to either a resource shortage,
              or a network problem.

       ccaannnnoott ssttaarrtt sseessssiioonn wwiitthh sseerrvveerr _s_e_r_v_e_r
              The  index  server  is  running,  but  refused  the



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        4





NSRINFO(8)                                             NSRINFO(8)


              connection.   The  exact  reason  is printed on the
              subsequent line of output.  The most likely reasons
              are  _p_e_r_m_i_s_s_i_o_n  _d_e_n_i_e_d  if  the user is not a Net-
              Worker administrator, and _s_e_r_v_i_c_e _b_u_s_y_,  _t_r_y  _a_g_a_i_n
              if  the  file index is locked (by nnssrrcckk(8),ffoorrexam-
              ple).

       llooookkuupp ffaaiilleedd ttoo sseerrvveerr _s_e_r_v_e_r
              The index server is running, but was unable to pro-
              cess the query.  The exact reason is printed on the
              subsequent line of output.

LLIIMMIITTAATTIIOONNSS
       The command line options should be  made  as  powerful  as
       those of mmmmiinnffoo(8).

       The --vv and --VV reports are not formatted into columns.

       A  query for a specific time can take a very long time due
       to the schema of the file index.

       The queries are limited due to the lack of a  cross  plat-
       form brower.


































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        5


