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/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 writ-
     ten.  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.

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

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/LC_MESSAGES.   If -m msgfile is
           also supplied, lOCALE is ignored for msgfiles contain-
           ing a /.

     -m msgfile
           Access files specified by one  or  more  msgfiles.  If
           msgfile contains a / character, then msgfile is inter-
           preted 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/LC_MESSAGES/* ) 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/LC_MESSAGE/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/LC_MESSAGES/UX  contained the fol-
     lowing 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: 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 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 typ-
     ing:

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

ENVIRONMENT VARIABLES

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

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)

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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.