1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
|
# This file documents the option groups EGLIBC currently supports, in
# a format akin to the Linux Kconfig system's. The syntax may change
# over time.
#
# An entry of the form:
#
# config OPTION_GROUP_NAME
# bool "one-line explanation of what this option group controls"
# help
# Multi-line help explaining the option group's meaning in
# some detail, terminated by indentation level.
#
# defines an option group whose variable is OPTION_GROUP_NAME, with
# meaningful values 'y' (enabled) and 'n' (disabled). The
# documentation is formatted to be consumed by some sort of
# interactive configuration interface, but EGLIBC doesn't have such an
# interface yet.
#
# An option may have a 'depends' line, indicating which other options
# must also be enabled if this option is. At present, EGLIBC doesn't
# check that these dependencies are satisfied.
#
# Option group variables get their default values from the file
# 'option-groups.defaults', in the top directory of the EGLIBC source
# tree. By default, all EGLIBC option groups are enabled --- their
# variables are set to 'y'.
#
# After including 'option-groups.defaults', the EGLIBC make machinery
# includes the file 'option-groups.config' from the top of the build
# tree, if it is present. Developers can place assignments to option
# group variables in that file to override the defaults. For example,
# to disable an option group, place a line of the form:
#
# OPTION_GROUP_NAME = n
#
# in 'option-groups.config' at the top of your build tree. To
# explicitly enable an option group, you may also write:
#
# OPTION_GROUP_NAME = y
#
# although this simply reestablishes the value already set by
# 'option-groups.defaults'.
config OPTION_EGLIBC_CATGETS
bool "Functions for accessing message catalogs"
depends OPTION_EGLIBC_LOCALE_CODE
help
This option group includes functions for accessing message
catalogs: catopen, catclose, and catgets.
This option group depends on the OPTION_EGLIBC_LOCALE_CODE
option group; if you disable that, you must also disable this.
config OPTION_EGLIBC_CHARSETS
bool "iconv/gconv character set conversion libraries"
help
This option group includes support for character sets other
than ASCII (ANSI_X3.4-1968) and Unicode and ISO-10646 in their
various encodings. This affects both the character sets
supported by the wide and multibyte character functions, and
those supported by the 'iconv' functions.
With this option group disabled, EGLIBC supports only the
following character sets:
ANSI_X3.4 - ASCII
ANSI_X3.4-1968
ANSI_X3.4-1986
ASCII
CP367
CSASCII
IBM367
ISO-IR-6
ISO646-US
ISO_646.IRV:1991
OSF00010020
US
US-ASCII
10646-1:1993 - ISO 10646, in big-endian UCS4 form
10646-1:1993/UCS4
CSUCS4
ISO-10646
ISO-10646/UCS4
OSF00010104
OSF00010105
OSF00010106
UCS-4
UCS-4BE
UCS4
UCS-4LE - ISO 10646, in little-endian UCS4 form
ISO-10646/UTF-8 - ISO 10646, in UTF-8 form
ISO-10646/UTF8
ISO-IR-193
OSF05010001
UTF-8
UTF8
ISO-10646/UCS2 - ISO 10646, in target-endian UCS2 form
OSF00010100
OSF00010101
OSF00010102
UCS-2
UCS2
UCS-2BE - ISO 10646, in big-endian UCS2 form
UNICODEBIG
UCS-2LE - ISO 10646, in little-endian UCS2 form
UNICODELITTLE
WCHAR_T - EGLIBC's internal form (target-endian,
32-bit ISO 10646)
config OPTION_EGLIBC_INET
bool "Networking support"
help
This option group includes networking-specific functions and
data. With OPTION_EGLIBC_INET disabled, the EGLIBC
installation and API changes as follows:
- The following libraries are not installed:
libanl
libnsl
libnss_compat
libnss_dns
libnss_hesiod
libnss_nis
libnss_nisplus
libresolv
- The following functions and variables are omitted from libc:
authdes_create hstrerror svc_fdset
authdes_getucred htonl svc_getreq
authdes_pk_create htons svc_getreq_common
authnone_create if_freenameindex svc_getreq_poll
authunix_create if_indextoname svc_getreqset
authunix_create_default if_nameindex svc_max_pollfd
bindresvport if_nametoindex svc_pollfd
callrpc in6addr_any svcraw_create
cbc_crypt in6addr_loopback svc_register
clnt_broadcast inet6_opt_append svc_run
clnt_create inet6_opt_find svc_sendreply
clnt_pcreateerror inet6_opt_finish svctcp_create
clnt_perrno inet6_opt_get_val svcudp_bufcreate
clnt_perror inet6_opt_init svcudp_create
clntraw_create inet6_option_alloc svcudp_enablecache
clnt_spcreateerror inet6_option_append svcunix_create
clnt_sperrno inet6_option_find svcunixfd_create
clnt_sperror inet6_option_init svc_unregister
clnttcp_create inet6_option_next user2netname
clntudp_bufcreate inet6_option_space xdecrypt
clntudp_create inet6_opt_next xdr_accepted_reply
clntunix_create inet6_opt_set_val xdr_array
des_setparity inet6_rth_add xdr_authdes_cred
ecb_crypt inet6_rth_getaddr xdr_authdes_verf
endaliasent inet6_rth_init xdr_authunix_parms
endhostent inet6_rth_reverse xdr_bool
endnetent inet6_rth_segments xdr_bytes
endnetgrent inet6_rth_space xdr_callhdr
endprotoent inet_addr xdr_callmsg
endrpcent inet_aton xdr_char
endservent inet_lnaof xdr_cryptkeyarg
ether_aton inet_makeaddr xdr_cryptkeyarg2
ether_aton_r inet_netof xdr_cryptkeyres
ether_hostton inet_network xdr_des_block
ether_line inet_nsap_addr xdr_double
ether_ntoa inet_nsap_ntoa xdr_enum
ether_ntoa_r inet_ntoa xdr_float
ether_ntohost inet_ntop xdr_free
freeaddrinfo inet_pton xdr_getcredres
freeifaddrs innetgr xdr_hyper
gai_strerror iruserok xdr_int
getaddrinfo iruserok_af xdr_int16_t
getaliasbyname key_decryptsession xdr_int32_t
getaliasbyname_r key_decryptsession_pk xdr_int64_t
getaliasent key_encryptsession xdr_int8_t
getaliasent_r key_encryptsession_pk xdr_keybuf
gethostbyaddr key_gendes xdr_key_netstarg
gethostbyaddr_r key_get_conv xdr_key_netstres
gethostbyname key_secretkey_is_set xdr_keystatus
gethostbyname2 key_setnet xdr_long
gethostbyname2_r key_setsecret xdr_longlong_t
gethostbyname_r netname2host xdrmem_create
gethostent netname2user xdr_netnamestr
gethostent_r ntohl xdr_netobj
getifaddrs ntohs xdr_opaque
getipv4sourcefilter passwd2des xdr_opaque_auth
get_myaddress pmap_getmaps xdr_pmap
getnameinfo pmap_getport xdr_pmaplist
getnetbyaddr pmap_rmtcall xdr_pointer
getnetbyaddr_r pmap_set xdr_quad_t
getnetbyname pmap_unset xdrrec_create
getnetbyname_r rcmd xdrrec_endofrecord
getnetent rcmd_af xdrrec_eof
getnetent_r registerrpc xdrrec_skiprecord
getnetgrent res_init xdr_reference
getnetgrent_r rexec xdr_rejected_reply
getnetname rexec_af xdr_replymsg
getprotobyname rexecoptions xdr_rmtcall_args
getprotobyname_r rpc_createerr xdr_rmtcallres
getprotobynumber rresvport xdr_short
getprotobynumber_r rresvport_af xdr_sizeof
getprotoent rtime xdrstdio_create
getprotoent_r ruserok xdr_string
getpublickey ruserok_af xdr_u_char
getrpcbyname ruserpass xdr_u_hyper
getrpcbyname_r setaliasent xdr_u_int
getrpcbynumber sethostent xdr_uint16_t
getrpcbynumber_r setipv4sourcefilter xdr_uint32_t
getrpcent setnetent xdr_uint64_t
getrpcent_r setnetgrent xdr_uint8_t
getrpcport setprotoent xdr_u_long
getsecretkey setrpcent xdr_u_longlong_t
getservbyname setservent xdr_union
getservbyname_r setsourcefilter xdr_unixcred
getservbyport svcauthdes_stats xdr_u_quad_t
getservbyport_r svcerr_auth xdr_u_short
getservent svcerr_decode xdr_vector
getservent_r svcerr_noproc xdr_void
getsourcefilter svcerr_noprog xdr_wrapstring
h_errlist svcerr_progvers xencrypt
h_errno svcerr_systemerr xprt_register
herror svcerr_weakauth xprt_unregister
h_nerr svc_exit
host2netname svcfd_create
- The rpcgen, nscd, and rpcinfo commands are not installed.
- The 'rpc' file (a text file listing RPC services) is not installed.
Socket-related system calls do not fall in this option group,
because many are also used for other inter-process
communication mechanisms. For example, the 'syslog' routines
use Unix-domain sockets to communicate with the syslog daemon;
syslog is valuable in non-networked contexts.
config OPTION_EGLIBC_LIBM
bool "libm (math library)"
help
This option group includes the 'libm' library, containing
mathematical functions. If this option group is omitted, then
an EGLIBC installation does not include shared or unshared versions
of the math library.
Note that this does not remove all floating-point related
functionality from EGLIBC; for example, 'printf' and 'scanf'
can still print and read floating-point values with this option
group disabled.
Note that the ISO Standard C++ library 'libstdc++' depends on
EGLIBC's math library 'libm'. If you disable this option
group, you will not be able to build 'libstdc++' against the
resulting EGLIBC installation.
config OPTION_EGLIBC_LOCALES
bool "Locale definitions"
help
This option group includes all locale definitions other than
that for the "C" locale. If this option group is omitted, then
only the "C" locale is supported.
config OPTION_EGLIBC_LOCALE_CODE
bool "Locale functions"
help
This option group includes locale support functions, programs,
and libraries. With OPTION_EGLIBC_LOCALE_FUNCTIONS disabled,
EGLIBC supports only the 'C' locale (also known as 'POSIX'),
and ignores the settings of the 'LANG' and 'LC_*' environment
variables.
With OPTION_EGLIBC_LOCALE_CODE disabled, the following
functions are omitted from libc:
duplocale localeconv nl_langinfo rpmatch strfmon_l
freelocale newlocale nl_langinfo_l strfmon uselocale
Furthermore, only the LC_CTYPE and LC_TIME categories of the
standard "C" locale are available.
The OPTION_EGLIBC_CATGETS option group depends on this option
group; if you disable OPTION_EGLIBC_LOCALE_CODE, you must also
disable OPTION_EGLIBC_CATGETS.
config OPTION_EGLIBC_NIS
bool "Support for NIS, NIS+, and the special 'compat' services."
depends OPTION_EGLIBC_INET
depends OPTION_EGLIBC_SUNRPC
help
This option group includes the NIS, NIS+, and 'compat' Name
Service Switch service libraries. When it is disabled, those
services libraries are not installed; you should remove any
references to them from your 'nsswitch.conf' file.
This option group depends on the OPTION_EGLIBC_INET option
group; you must enable that to enable this option group.
config OPTION_EGLIBC_NSSWITCH
bool "Name service switch (nsswitch) support"
help
This option group includes support for the 'nsswitch' facility.
With this option group enabled, all EGLIBC functions for
accessing various system databases (passwords and groups;
networking; aliases; public keys; and so on) consult the
'/etc/nsswitch.conf' configuration file to decide how to handle
queries.
With this option group disabled, EGLIBC uses a fixed list of
services to satisfy queries on each database, as requested by
configuration files specified when EGLIBC is built. Your
'option-groups.config' file must set the following two
variables:
OPTION_EGLIBC_NSSWITCH_FIXED_CONFIG
Set this to the name of a file whose contents observe the
same syntax as an ordinary '/etc/nsswitch.conf' file. The
EGLIBC build process parses this file just as EGLIBC would
at run time if OPTION_EGLIBC_NSSWITCH were enabled, and
produces a C library that uses the nsswitch service
libraries to search for database entries as this file
specifies, instead of consulting '/etc/nsswitch.conf' at run
time.
This should be a relative file name; EGLIBC will look for it
in the top build directory, along with the
'option-groups.config' file.
The EGLIBC source tree includes a sample configuration file
named 'nss/fixed-nsswitch.conf'; for simple configurations,
you will probably want to delete references to databases not
needed on your system.
OPTION_EGLIBC_NSSWITCH_FIXED_FUNCTIONS
The EGLIBC build process uses this file to decide which
functions to make available from which service libraries.
The file 'nss/fixed-nsswitch.functions' serves as a sample
configuration file for this setting, and explains its syntax
and meaning in more detail.
This should be a relative file name; EGLIBC will look for it
in the top build directory, along with the
'option-groups.config' file.
Be sure to mention each function in each service you wish to
use. If you do not mention a service's function here, the
EGLIBC database access functions will not find it, even if
it is listed in the OPTION_EGLIBC_NSSWITCH_FIXED_CONFIG
file.
In this arrangement, EGLIBC will not use the 'dlopen' and
'dlsym' functions to find database access functions. Instead,
libc hard-codes references to the service libraries' database
access functions. You must explicitly link your program
against the name service libraries (those whose names start
with 'libnss_', in the sysroot's '/lib' directory) whose
functions you intend to use. This arrangement helps
system-wide static analysis tools decide which functions a
system actually uses.
Note that some nsswitch service libraries require other option
groups to be enabled; for example, the OPTION_EGLIBC_INET
option group must be enabled to use the 'libnss_dns.so.2' or
'libnss_nis.so.2' service libraries, which use the Domain Name
System and Network Information Service network protocols to
answer queries.
config OPTION_EGLIBC_SUNRPC
bool "Support for the Sun 'RPC' protocol."
depends OPTION_EGLIBC_INET
help
This option group includes support for the Sun RPC protocols,
including the 'rpcgen' and 'rpcinfo' programs.
config OPTION_POSIX_REGEXP
bool "Regular expressions"
help
This option group includes the POSIX regular expression
functions, and the associated non-POSIX extensions and
compatibility functions.
With OPTION_POSIX_REGEXP disabled, the following functions are
omitted from libc:
re_comp re_max_failures regcomp
re_compile_fastmap re_search regerror
re_compile_pattern re_search_2 regexec
re_exec re_set_registers regfree
re_match re_set_syntax rpmatch
re_match_2 re_syntax_options
Furthermore, the compatibility regexp interface defined in the
<regexp.h> header file, 'compile', 'step', and 'advance', is
omitted.
|
