[BACK]Return to catopen.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / nls

File: [cvs.NetBSD.org] / src / lib / libc / nls / catopen.3 (download)

Revision 1.5, Thu May 11 23:03:44 1995 UTC (25 years, 2 months ago) by jtc
Branch: MAIN
CVS Tags: nsswitch, netbsd-1-3-base, netbsd-1-3-RELEASE, netbsd-1-3-PATCH003-CANDIDATE2, netbsd-1-3-PATCH003-CANDIDATE1, netbsd-1-3-PATCH003-CANDIDATE0, netbsd-1-3-PATCH003, netbsd-1-3-PATCH002, netbsd-1-3-PATCH001, netbsd-1-3-BETA, netbsd-1-3, netbsd-1-2-base, netbsd-1-2-RELEASE, netbsd-1-2-PATCH001, netbsd-1-2-BETA, netbsd-1-2, netbsd-1-1-base, netbsd-1-1-RELEASE, netbsd-1-1-PATCH001, netbsd-1-1, ivory_soap2
Changes since 1.4: +3 -28 lines

Winning Strategies has placed this code in the public domain.

.\"	$NetBSD: catopen.3,v 1.5 1995/05/11 23:03:44 jtc Exp $
.\"
.\" Written by J.T. Conklin <jtc@netbsd.org>.
.\" Public domain.
.\"
.Dd May 29, 1994
.Dt CATOPEN 3
.Os
.Sh NAME
.Nm catopen
.Nd open message catalog 
.Sh SYNOPSIS
.Fd #include <nl_types.h>
.Ft nl_catd
.Fn catopen "const char *name" "int oflag"
.Sh DESCRIPTION
The 
.Fn catopen
function opens the message catalog specified by
.Fa name 
and returns a message catalog descriptor.
If
.Fa name
contains a
.Sq / 
then 
.Fa name
specifies the full pathname for the message catalog, otherwise the value 
of the environment variable
.Ev NLSPATH 
is used with 
.Fa name
substituted for %N.
.Pp
The
.Fa oflag
argument is reserved for future use and should be set to zero.
.Sh RETURN VALUE
Upon successful completion, 
.Fn catopen
returns a message catalog descriptor.
Otherwise, (nl_catd) -1 is returned and
.Va errno 
is set to indicate the error.
.Sh ERRORS
.Bl -tag -width Er
.It Bq Er ENOMEM
Insufficient memory is availiable.
.El
.Sh SEE ALSO
.Xr catclose 3 ,
.Xr catgets 3
.Sh STANDARDS
The
.Fn catopen
function conforms to
.St -xpg3 .