Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

srchtxt


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 containing a /.



     -m msgfile      Access  files  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
                     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.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments