srchtxt(1)                 (Essential Utilities)                 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/LCMESSAGES (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.  If the -l option is not specified, the files accessed will
         be determined by the value of the environment variable LCMESSAGES.
         If LCMESSAGES 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/LCMESSAGES, which contains default strings.

         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/LCMESSAGES.  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.

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





   7/91                                                                 Page 1

   srchtxt(1)                 (Essential Utilities)                 srchtxt(1)


         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/LCMESSAGES/*) by typing:

                     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/LCMESSAGES/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:

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

               If /usr/lib/locale/french/LCMESSAGES/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


   Page 2                                                                 7/91

   srchtxt(1)                 (Essential Utilities)                 srchtxt(1)


                     <UX:6>Fichier trop long\n

         Example 3:

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

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

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

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

   SEE ALSO
         ed(1), exstr(1), gettxt(1), mkmsgs(1).
         gettxt(3C), setlocale(3C) in the Programmer's Reference Manual.

   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.
























   7/91                                                                 Page 3