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/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. If the -l option is not specified, the files accessed will be determined by the value of the environment variable LC_MESSAGES. If LC_MESSAGES 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/LC_MESSAGES, 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/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.

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 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/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 typing:
          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 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/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)  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.