srchtxt(1)            UNIX System V(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>.

      msgfile     name of the file where the displayed text occurred

      msgnum      sequence number in msgfile where the displayed text occurred




10/89                                                                    Page 1

srchtxt(1)            UNIX System V(Essential Utilities)             srchtxt(1)


      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
                  <UX:6>Fichier trop long\n

      Example 3:





Page 2                                                                    10/89

srchtxt(1)            UNIX System V(Essential Utilities)             srchtxt(1)


            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.






























10/89                                                                    Page 3