usr/src/man/man3nsl/nlsprovider.3nsl

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH NLSPROVIDER 3NSL "Nov 14, 2002"
   7 .SH NAME
   8 nlsprovider \- get name of transport provider
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBchar *\fR\fBnlsprovider\fR(\fBvoid\fR);
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBnlsprovider()\fR returns a pointer to a null-terminated character string
  19 which contains the name of the transport provider as placed in the environment
  20 by the listener process.  If the variable is not defined in the environment, a
  21 NULL pointer is returned.
  22 .sp
  23 .LP
  24 The environment variable is only available to server processes started by the
  25 listener process.
  26 .SH RETURN VALUES
  27 .sp
  28 .LP
  29 If the variable is not defined in the environment, a NULL pointer is returned.
  30 .SH FILES
  31 .sp
  32 .ne 2
  33 .na
  34 \fB\fB/usr/lib/libnls.so.1\fR\fR
  35 .ad
  36 .RS 24n
  37 shared object
  38 .RE
  39
  40 .SH ATTRIBUTES
  41 .sp
  42 .LP
  43 See \fBattributes\fR(5) for descriptions of the following attributes:
  44 .sp
  45
  46 .sp
  47 .TS
  48 box;
  49 c | c
  50 l | l .
  51 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  52 _
  53 MT-Level        Unsafe
  54 .TE
  55
  56 .SH SEE ALSO
  57 .sp
  58 .LP
  59 \fBnlsadmin\fR(1M), \fBattributes\fR(5)
  60 .SH NOTES
  61 .sp
  62 .LP
  63 This interface is unsafe in multithreaded applications.  Unsafe interfaces
  64 should be called only from the main thread.