Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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/lo-
       cale/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  en-
       vironment variable LANG.	If LANG	is not set, the	files accessed will be
       in the directory	/usr/lib/locale//C/LC_MESSAGES ,  which	 contains  de-
       fault 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 oc-
		       curred

       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/lo-
		       cale/LC_MESSAGES.   If -m msgfile is also supplied, lO-
		       CALE is ignored for msgfiles containing 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/lo-
       cale/french/LC_MESSAGE/UX ), then, using	the value of the LANG environ-
       ment 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:

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

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | FILES | ATTRIBUTES | SEE ALSO | DIAGNOSTICS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=srchtxt&sektion=1&manpath=SunOS+5.10>

home | help