catopen man page on HP-UX

Printed from

catopen(3C)							   catopen(3C)

       catopen(), catclose() - open and close a message catalog for reading

       The  function opens a message catalog and returns a catalog descriptor.
       The specifies the name of the message catalog being opened.  A contain‐
       ing  a slash specifies a path name for the message catalog.  Otherwise,
       the environment variable is used (see environ(5)).  If  specifies  more
       than  one  path,	 returns  the catalog descriptor for the first path on
       which it is able to successfully open the  specified  message  catalog.
       If does not exist in the environment, or if a message catalog cannot be
       opened for any path, uses a system-wide default path.  The  default  is
       affected	 by if the value of is If the value of is zero, the default is
       affected by the environment variable See environ(5) for details.

       If is invoked from or programs with owner root, the  environment	 vari‐
       able  is	 not  directly	used to locate message catalogs.  Instead, the
       paths which are available both in the configuration file	 and  environ‐
       ment   variable	 are  considered  to  locate  message  catalogs.   See
       nlspath(4) for details.

       Example: If the environment variable is set to:

       and the configuration file has an entry:

       only path is considered for locating catalog files.   This  feature  is
       provided	 only  for  backward  compatibility for those or root programs
       which are depending on the environment variable.	 All new or root  pro‐
       grams should not depend on the environment variable and should only use
       absolute path names.

       A message catalog descriptor remains  valid  in	a  process  until  the
       process	closes	it or until a successful call to one of the functions.
       A change in the setting of the category may  invalidate	existing  open

       A  file	descriptor is used to implement the message catalog descriptor
       and the close-on-exec flag is set for the  message  catalog  descriptor
       (see fcntl(2)).

       If is zero, the environment variable is used to locate the catalog.  If
       is the category is used to locate the message catalog only  if  a  suc‐
       cessful	call  to has been made prior to the call to The result of set‐
       ting to any other value is undefined.

       The function closes the message catalog a  message  catalog  descriptor
       returned from an earlier successful call to

       Upon success, returns a message catalog descriptor.  Otherwise, returns
       a value of (nl_catd)−1 and sets to indicate the error.

       Upon success, returns zero.  Otherwise, returns −1 and sets to indicate
       the error.

       fails  without  opening	a  message  catalog and sets for the last path
       attempted under any of the following conditions:

	      A component of the path prefix denies search permission, or
				     read permission is denied for  the	 named

	      The  maximum  number  of	file descriptors allowed are currently

	      The length of the specified path name exceeds
				     bytes, or the length of  a	 component  of
				     the  path	name exceeds bytes while is in

	      The system file table is full.

	      The named catalog does not exist or the path is null.

	      A component of the path prefix is not a directory.

       can be used to provide default messages when called following a	failed
       (see  catgets(3C)).   returns  its parameter if it is passed an invalid
       catalog descriptor.

       fails if the following is true:

	      is not a valid open message catalog descriptor.

       When using does not provide a default value for

       and were developed by HP.

       Include file containing native language types.

       Message catalog default path for core HP-UX products only.

       fcntl(2),   catgets(3C),	  setlocale(3C),    nlspath(4),	   environ(5),


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net