unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

srchtxt(1)                       User Commands                      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: <&lt;msgfile:msgnum>&gt;.

       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 msg-
                       file 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  dis-
                       play 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  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: 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 pat-
       tern [Dd]atei in both the files UX and ingress in the german locale  by
       typing:

       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 attributes:


       tab() box; cw(2.750000i)| cw(2.750000i)  lw(2.750000i)|  lw(2.750000i).
       ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWloc


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-explana-
       tory.  They indicate an error in the command line or errors encountered
       while searching for a particular locale and/or message file.



SunOS 5.10                        20 Dec 1996                       srchtxt(1)