Manual Pages for UNIX Operating System command usage for man srchtxt
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: .
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
SunOS 5.11 Last change: 20 Dec 1996 1
User Commands srchtxt(1)
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:
SunOS 5.11 Last change: 20 Dec 1996 2
User Commands srchtxt(1)
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:
Fichier inexistant\n
Trop de fichiers ouverts\n
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)
SunOS 5.11 Last change: 20 Dec 1996 3
User Commands srchtxt(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.
SunOS 5.11 Last change: 20 Dec 1996 4