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


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

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
pattern [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(7) 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)

SEE ALSO

exstr(1), gettxt(1), locale(1), mkmsgs(1), gettxt(3C), setlocale(3C),
attributes(7), environ(7), locale(7), regexp(7)

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.

December 20, 1996 SRCHTXT(1)