User Commands                                          srchtxt(1)



NAME
     srchtxt - display contents of, or search for a  text  string
     in, message data bases

SYNOPSIS
     srchtxt [-s] [-l locale] [-m msgfile ,...] [text]


DESCRIPTION
     The srchtxt utility is used to display all the text  strings
     in  message  data  bases,  or to search for a text string in
     message data bases (see mkmsgs(1)).  These  data  bases  are
     files  in  the  directory /usr/lib/locale/locale/LCMESAGES
     (see setlocale(3C)), unless a file name given  with  the  -m
     option  contains  a /. The directory locale can be viewed as
     the name of the language in which the text strings are writ-
     ten.  If  the -l option is not specified, the files accessed
     will be determined by the value of the environment  variable
     LCMESAGES.  If  LCMESAGES is not set, the files accessed
     will be determined by the value of the environment  variable
     LANG.  If LANG is not set, the files accessed will be in the
     directory /usr/lib/locale/C/LCMESAGES  ,  which  contains
     default strings.


     If no text argument is present, then all the text strings in
     the files accessed will be displayed.


     If the -s option is not specified,  the  displayed  text  is
     prefixed  by  message sequence numbers. The message sequence
     numbers are enclosed in angle brackets: .

     msgfile     name  of  the  file  where  the  displayed  text
                 occurred


     msgnum      sequence number in msgfile where  the  displayed
                 text occurred



     This  display  is  in  the  format  used  by  gettxt(1)  and
     gettxt(3C).

OPTIONS
     -s            Suppress  printing  of  the  message  sequence
                   numbers of the messages being displayed.


     -l locale     Access     files     in     the      directory
                   /usr/lib/locale/locale/LCMESAGES.    If   -m



SunOS 5.11          Last change: 20 Dec 1996                    1






User Commands                                          srchtxt(1)



                   msgfile is also supplied,  lOCALE  is  ignored
                   for msgfiles containing a /.


     -m msgfile    Access  files  specified  by   one   or   more
                   msgfiles.  If  msgfile contains a / character,
                   then msgfile is  interpreted  as  a  pathname;
                   otherwise,  it  will  be  assumed to be in the
                   directory determined as  described  above.  To
                   specify  more  than  one msgfile, separate the
                   file names using commas.


     text          Search for the text string specified  by  text
                   and  display  each  one that matches. text can
                   take the form of  a  regular  expression;  see
                   regexp(5).


EXAMPLES
     Example 1 Using srchtxt


     If message files have  been  installed  in  a  locale  named
     french by using mkmsgs(1), then you could display the entire
     set   of    text    strings    in    the    french    locale
     (/usr/lib/locale/french/LCMESAGES/* ) by typing:


       example% srchtxt -l french



     Example 2 Using srchtxt


     If a set of error messages  associated  with  the  operating
     system  have  been  installed  in  the file UX in the french
     locale (/usr/lib/locale/french/LCMESAGE/UX ), then,  using
     the  value of the LANG environment variable to determine the
     locale to be searched, you could search that  file  in  that
     locale for all error messages dealing with files by typing:


       example% setenv LANG=french; export  LANG
       example% srchtxt -m UX "[Ff]ichier"




     If /usr/lib/locale/french/LCMESAGES/UX  contained the fol-
     lowing strings:



SunOS 5.11          Last change: 20 Dec 1996                    2






User Commands                                          srchtxt(1)



       Erreur E/S\n
       Liste d'arguments trop longue\n
       Fichier inexistant\n
       Argument invalide\n
       Trop de fichiers ouverts\n
       Fichier trop long\n
       Trop de liens\n
       Argument hors du domaine\n
       Identificateur supprim\n
       Etreinte fatale\n
         .
         .
         .



     then the following strings would be displayed:


       Fichier inexistant\n
       Trop de fichiers ouverts\n
       Fichier trop long\n



     Example 3 Using srchtxt


     If a set of error messages  associated  with  the  operating
     system have been installed in the file UX and a set of error
     messages associated with the INGRES data base product  have
     been  installed  in  the  file  ingress,  both in the german
     locale, then you could search for the  pattern  [Dd]atei  in
     both  the  files UX and ingress in the german locale by typ-
     ing:


       example% srchtxt -l german -m UX,ingress "[Dd]atei"



ENVIRONMENT VARIABLES
     See environ(5) for a description of the LCTYPE environment
     variable that affects the execution of srchtxt.

FILES
     /usr/lib/locale/C/LCMESAGES/*

         default files created by mkmsgs(1)






SunOS 5.11          Last change: 20 Dec 1996                    3






User Commands                                          srchtxt(1)



     /usr/lib/locale/locale/LCMESAGES/*

         message files created by mkmsgs(1)


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
     ATRIBUTE TYPE                ATRIBUTE VALUE             
     Availability                  SUNWloc                     
    


SEE ALSO
     exstr(1),  gettxt(1),  locale(1),   mkmsgs(1),   gettxt(3C),
     setlocale(3C),    attributes(5),    environ(5),   locale(5),
     regexp(5)

DIAGNOSTICS
     The error messages produced by srchtxt are  intended  to  be
     self-explanatory. They indicate an error in the command line
     or errors  encountered  while  searching  for  a  particular
     locale and/or message file.




























SunOS 5.11          Last change: 20 Dec 1996                    4