1 '\" te
2 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All rights reserved.
4 .\" Copyright 2016 Joyent, Inc.
5 .\" 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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
6 .\" See the License for the specific language governing permissions and limitations under the License. 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
7 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 .\" Copyright 2011 by Delphix. All rights reserved.
9 .TH LIBC 3LIB "Dec 10, 2015"
10 .SH NAME
11 libc \- C library
12 .SH DESCRIPTION
13 .LP
14 Functions in this library provide various facilities defined by System V, ANSI
15 C, POSIX, and so on. See \fBstandards\fR(5). In addition, those facilities
16 previously defined in the internationalization and the wide-character libraries
17 are now defined in this library, as are the facilities previously defined in
18 the multithreading libraries, \fBlibthread\fR and \fBlibpthread\fR.
19 .SH INTERFACES
20 .LP
21 The shared object \fBlibc.so.1\fR provides the public interfaces defined below.
22 See \fBIntro\fR(3) for additional information on shared object interfaces.
23 .sp
24
25 .sp
26 .TS
27 l l
28 l l .
29 \fB____loc1\fR \fB___errno\fR
30 \fB__builtin_alloca\fR \fB__ctype\fR
31 \fB__fbufsize\fR \fB__flbf\fR
32 \fB__flt_rounds\fR \fB__fpending\fR
33 \fB__fpurge\fR \fB__freadable\fR
34 \fB__freading\fR \fB__fsetlocking\fR
35 \fB__fwritable\fR \fB__fwriting\fR
36 \fB__huge_val\fR \fB__iob\fR
37 \fB__loc1\fR \fB__major\fR
38 \fB__makedev\fR \fB__mb_cur_max_l\fR
39 \fB__minor\fR
40 \fB__nsw_extended_action\fR \fB__nsw_freeconfig\fR
285 \fBgetgrent\fR \fBgetgrent_r\fR
286 \fBgetgrgid\fR \fBgetgrgid_r\fR
287 \fBgetgrnam\fR \fBgetgrnam_r\fR
288 \fBgetgroups\fR \fBgethomelgroup\fR
289 \fBgethostid\fR \fBgethostname\fR
290 \fBgethrtime\fR \fBgethrvtime\fR
291 \fBgetisax\fR \fBgetitimer\fR
292 \fBgetloadavg\fR \fBgetlogin\fR
293 \fBgetlogin_r\fR \fBgetmntany\fR
294 \fBgetmntent\fR \fBgetmsg\fR
295 \fBget_nprocs\fR \fBget_nprocs_conf\fR
296 \fBgetnetgrent\fR \fBgetnetgrent_r\fR
297 \fBgetopt\fR \fBgetopt_clip\fR
298 \fBgetopt_long\fR \fBgetopt_long_only\fR
299 \fBgetpagesize\fR \fBgetpagesizes\fR
300 \fBgetpass\fR \fBgetpassphrase\fR
301 \fBgetpeerucred\fR \fBgetpflags\fR
302 \fBgetpgid\fR \fBgetpgrp\fR
303 \fBgetpid\fR \fBgetpmsg\fR
304 \fBgetppid\fR \fBgetppriv\fR
305 \fBgetpriority\fR \fbgetprogname\fR
306 \fBgetprojid\fR
307 \fBgetpw\fR \fBgetpwent\fR
308 \fBgetpwent_r\fR \fBgetpwnam\fR
309 \fBgetpwnam_r\fR \fBgetpwuid\fR
310 \fBgetpwuid_r\fR \fBgetrctl\fR
311 \fBgetrlimit\fR \fBgetrusage\fR
312 \fBgets\fR \fBgetsid\fR
313 \fBgetspent\fR \fBgetspent_r\fR
314 \fBgetspnam\fR \fBgetspnam_r\fR
315 \fBgetsubopt\fR \fBgettaskid\fR
316 \fBgettext\fR \fBgettimeofday\fR
317 \fBgettxt\fR \fBgetuid\fR
318 \fBgetusershell\fR \fBgetustack\fR
319 \fBgetutent\fR \fBgetutid\fR
320 \fBgetutline\fR \fBgetutmp\fR
321 \fBgetutmpx\fR \fBgetutxent\fR
322 \fBgetutxid\fR \fBgetutxline\fR
323 \fBgetvfsany\fR \fBgetvfsent\fR
324 \fBgetvfsfile\fR \fBgetvfsspec\fR
325 \fBgetw\fR
978 .ne 2
979 .na
980 \fB\fB/lib/c_synonyms.so.1\fR\fR
981 .ad
982 .RS 27n
983 A compatibility library to provide access to obsolete \fBlibc\fR synonym
984 symbols
985 .RE
986
987 .sp
988 .ne 2
989 .na
990 \fB\fB/lib/64/c_synonyms.so.1\fR\fR
991 .ad
992 .RS 27n
993 A 64-bit compatibility library to provide access to obsolete \fBlibc\fR synonym
994 symbols
995 .RE
996
997 .SH ATTRIBUTES
998 .LP
999 See \fBattributes\fR(5) for descriptions of the following attributes:
1000 .sp
1001
1002 .sp
1003 .TS
1004 box;
1005 c | c
1006 l | l .
1007 ATTRIBUTE TYPE ATTRIBUTE VALUE
1008 MT-Level Safe
1009 .TE
1010
1011 .SH SEE ALSO
1012 .LP
1013 \fBpvs\fR(1), \fBIntro\fR(2), \fBIntro\fR(3), \fBattributes\fR(5),
1014 \fBlf64\fR(5), \fBstandards\fR(5)
1015 .SH NOTES
1016 .LP
1017 The synonyms compatibility library, \fBc_synonyms.so.1\fR, provides a mechanism
1018 to support old applications and libraries that were mistakenly built using
1019 now-obsolete synonym symbols from \fBlibc\fR.
1020 .LP
1021 Before the advent of direct binding (-B direct) \fBlibc\fR provided many
1022 functions with two names. For example, \fBgetpwent()\fR and \fB_getpwent()\fR.
1023 These two names referred to exactly the same function in \fBlibc\fR. The
1024 leading-underscore symbol was intended to be used by system libraries in order
1025 to avoid conflicting with an application that might define its own version of
1026 \fBgetpwent()\fR with completely different semantics. Standard-conforming
1027 applications may not define and use function names with leading underscores.
1028 .LP
1029 illumos system libraries are now built with direct binding. This means that a
1030 system library that calls \fBgetpwent()\fR will bind directly to the instance
1031 of \fBgetpwent()\fR in \fBlibc\fR, even if the application to which it is
1032 linked defines a different \fBgetpwent()\fR for its own use. The application
1033 binds to its instance of \fBgetpwent()\fR and there is no resulting conflict.
1034 The direct binding mechanism is equally available to libraries not delivered
1035 with illumos.
1036 .LP
|
1 '\" te
2 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All rights reserved.
4 .\" Copyright 2016 Joyent, Inc.
5 .\" 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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
6 .\" See the License for the specific language governing permissions and limitations under the License. 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
7 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 .\" Copyright 2011 by Delphix. All rights reserved.
9 .TH LIBC 3LIB "Dec 10, 2015"
10 .SH NAME
11 libc \- C library
12 .SH DESCRIPTION
13 Functions in this library provide various facilities defined by System V, ANSI
14 C, POSIX, and so on. See \fBstandards\fR(5). In addition, those facilities
15 previously defined in the internationalization and the wide-character libraries
16 are now defined in this library, as are the facilities previously defined in
17 the multithreading libraries, \fBlibthread\fR and \fBlibpthread\fR.
18 .SH INTERFACES
19 The shared object \fBlibc.so.1\fR provides the public interfaces defined below.
20 See \fBIntro\fR(3) for additional information on shared object interfaces.
21 .sp
22
23 .sp
24 .TS
25 l l
26 l l .
27 \fB____loc1\fR \fB___errno\fR
28 \fB__builtin_alloca\fR \fB__ctype\fR
29 \fB__fbufsize\fR \fB__flbf\fR
30 \fB__flt_rounds\fR \fB__fpending\fR
31 \fB__fpurge\fR \fB__freadable\fR
32 \fB__freading\fR \fB__fsetlocking\fR
33 \fB__fwritable\fR \fB__fwriting\fR
34 \fB__huge_val\fR \fB__iob\fR
35 \fB__loc1\fR \fB__major\fR
36 \fB__makedev\fR \fB__mb_cur_max_l\fR
37 \fB__minor\fR
38 \fB__nsw_extended_action\fR \fB__nsw_freeconfig\fR
283 \fBgetgrent\fR \fBgetgrent_r\fR
284 \fBgetgrgid\fR \fBgetgrgid_r\fR
285 \fBgetgrnam\fR \fBgetgrnam_r\fR
286 \fBgetgroups\fR \fBgethomelgroup\fR
287 \fBgethostid\fR \fBgethostname\fR
288 \fBgethrtime\fR \fBgethrvtime\fR
289 \fBgetisax\fR \fBgetitimer\fR
290 \fBgetloadavg\fR \fBgetlogin\fR
291 \fBgetlogin_r\fR \fBgetmntany\fR
292 \fBgetmntent\fR \fBgetmsg\fR
293 \fBget_nprocs\fR \fBget_nprocs_conf\fR
294 \fBgetnetgrent\fR \fBgetnetgrent_r\fR
295 \fBgetopt\fR \fBgetopt_clip\fR
296 \fBgetopt_long\fR \fBgetopt_long_only\fR
297 \fBgetpagesize\fR \fBgetpagesizes\fR
298 \fBgetpass\fR \fBgetpassphrase\fR
299 \fBgetpeerucred\fR \fBgetpflags\fR
300 \fBgetpgid\fR \fBgetpgrp\fR
301 \fBgetpid\fR \fBgetpmsg\fR
302 \fBgetppid\fR \fBgetppriv\fR
303 \fBgetpriority\fR \fBgetprogname\fR
304 \fBgetprojid\fR
305 \fBgetpw\fR \fBgetpwent\fR
306 \fBgetpwent_r\fR \fBgetpwnam\fR
307 \fBgetpwnam_r\fR \fBgetpwuid\fR
308 \fBgetpwuid_r\fR \fBgetrctl\fR
309 \fBgetrlimit\fR \fBgetrusage\fR
310 \fBgets\fR \fBgetsid\fR
311 \fBgetspent\fR \fBgetspent_r\fR
312 \fBgetspnam\fR \fBgetspnam_r\fR
313 \fBgetsubopt\fR \fBgettaskid\fR
314 \fBgettext\fR \fBgettimeofday\fR
315 \fBgettxt\fR \fBgetuid\fR
316 \fBgetusershell\fR \fBgetustack\fR
317 \fBgetutent\fR \fBgetutid\fR
318 \fBgetutline\fR \fBgetutmp\fR
319 \fBgetutmpx\fR \fBgetutxent\fR
320 \fBgetutxid\fR \fBgetutxline\fR
321 \fBgetvfsany\fR \fBgetvfsent\fR
322 \fBgetvfsfile\fR \fBgetvfsspec\fR
323 \fBgetw\fR
976 .ne 2
977 .na
978 \fB\fB/lib/c_synonyms.so.1\fR\fR
979 .ad
980 .RS 27n
981 A compatibility library to provide access to obsolete \fBlibc\fR synonym
982 symbols
983 .RE
984
985 .sp
986 .ne 2
987 .na
988 \fB\fB/lib/64/c_synonyms.so.1\fR\fR
989 .ad
990 .RS 27n
991 A 64-bit compatibility library to provide access to obsolete \fBlibc\fR synonym
992 symbols
993 .RE
994
995 .SH ATTRIBUTES
996 See \fBattributes\fR(5) for descriptions of the following attributes:
997 .sp
998
999 .sp
1000 .TS
1001 box;
1002 c | c
1003 l | l .
1004 ATTRIBUTE TYPE ATTRIBUTE VALUE
1005 MT-Level Safe
1006 .TE
1007
1008 .SH SEE ALSO
1009 \fBpvs\fR(1), \fBIntro\fR(2), \fBIntro\fR(3), \fBattributes\fR(5),
1010 \fBlf64\fR(5), \fBstandards\fR(5)
1011 .SH NOTES
1012 The synonyms compatibility library, \fBc_synonyms.so.1\fR, provides a mechanism
1013 to support old applications and libraries that were mistakenly built using
1014 now-obsolete synonym symbols from \fBlibc\fR.
1015 .LP
1016 Before the advent of direct binding (-B direct) \fBlibc\fR provided many
1017 functions with two names. For example, \fBgetpwent()\fR and \fB_getpwent()\fR.
1018 These two names referred to exactly the same function in \fBlibc\fR. The
1019 leading-underscore symbol was intended to be used by system libraries in order
1020 to avoid conflicting with an application that might define its own version of
1021 \fBgetpwent()\fR with completely different semantics. Standard-conforming
1022 applications may not define and use function names with leading underscores.
1023 .LP
1024 illumos system libraries are now built with direct binding. This means that a
1025 system library that calls \fBgetpwent()\fR will bind directly to the instance
1026 of \fBgetpwent()\fR in \fBlibc\fR, even if the application to which it is
1027 linked defines a different \fBgetpwent()\fR for its own use. The application
1028 binds to its instance of \fBgetpwent()\fR and there is no resulting conflict.
1029 The direct binding mechanism is equally available to libraries not delivered
1030 with illumos.
1031 .LP
|