srchtxt(1)                                                          srchtxt(1)


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

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

DESCRIPTION
     The srchtxt utility is used to display all the text strings in message
     databases, or to search for a text string in message databases [see
     mkmsgs(1)].  These databases are files in the directory
     /usr/lib/locale/locale/LC_MESSAGES [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 written.
     When the -l option is not used, the locale directory searched is
     specified by the LC_MESSAGES environment variable if it is set to a non-
     empty value.  Otherwise, it is specified by the environment variable LANG
     if it is set to a non-empty value.  Otherwise, the directory C is used.
     Text strings may contain supplementary code set characters.

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

     The meanings of the options are as follows:

     -s          suppress printing of the message sequence numbers of the
                 messages being displayed

     -l locale   access files in the directory
                 /usr/lib/locale/locale/LC_MESSAGES.  If -m msgfile is also
                 supplied, locale is ignored for msgfiles containing a /.

     -m msgfile  access file(s) 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.

     -i msgnum   display only the message whose numeric id equals msgnum.
                 This option should not normally be used with a search text.

     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 ed(1)].

     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:msgnum>.

     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).

EXAMPLES
     The following examples show uses of srchtxt.

     Example 1:

          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/LC_MESSAGES/*)
          by entering:
               srchtxt -l french

     Example 2:

          If a set of error messages associated with the UNIX operating system
          have been installed in the file UX in the french locale
          (/usr/lib/locale/french/LC_MESSAGES/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 entering:

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

          If /usr/lib/locale/french/LC_MESSAGES/UX contained the following
          strings:

               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:
               <UX:3>Fichier inexistant\n
               <UX:5>Trop de fichiers ouverts\n
               <UX:6>Fichier trop long\n


     Example 3:

          If a set of error messages associated with the UNIX operating system
          has been installed in the file UX and a set of error messages
          associated with the INGRESS database 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 entering:

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

FILES
     /usr/lib/locale/C/LC_MESSAGES/*         default files created by
                                             mkmsgs(1)

     /usr/lib/locale/locale/LC_MESSAGES/*    message files created by
                                             mkmsgs(1)

SEE ALSO
     ed(1), exstr(1), gettxt(1), mkmsgs(1), gettxt(3C), setlocale(3C),
     environ(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.


                                                                        Page 3