manual: Add documentation for arc4random functions
[glibc.git] / stdlib / Makefile
bloba9009626855b78efe05266703224abb9ce605d6c
1 # Copyright (C) 1991-2022 Free Software Foundation, Inc.
2 # This file is part of the GNU C Library.
4 # The GNU C Library is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU Lesser General Public
6 # License as published by the Free Software Foundation; either
7 # version 2.1 of the License, or (at your option) any later version.
9 # The GNU C Library is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 # Lesser General Public License for more details.
14 # You should have received a copy of the GNU Lesser General Public
15 # License along with the GNU C Library; if not, see
16 # <https://www.gnu.org/licenses/>.
19 # Makefile for stdlib routines
21 subdir := stdlib
23 include ../Makeconfig
25 headers := \
26 alloca.h \
27 bits/errno.h \
28 bits/indirect-return.h \
29 bits/monetary-ldbl.h \
30 bits/stdint-intn.h \
31 bits/stdint-uintn.h \
32 bits/stdlib-bsearch.h \
33 bits/stdlib-float.h \
34 bits/stdlib.h \
35 bits/stdlib-ldbl.h \
36 bits/time64.h \
37 bits/timesize.h \
38 bits/types/error_t.h \
39 bits/wordsize.h \
40 errno.h \
41 fmtmsg.h \
42 inttypes.h \
43 monetary.h \
44 stdint.h \
45 stdlib.h \
46 sys/errno.h \
47 sys/random.h \
48 sys/ucontext.h \
49 ucontext.h \
50 # headers
52 routines := \
53 a64l \
54 abort \
55 abs \
56 arc4random \
57 arc4random_uniform \
58 at_quick_exit \
59 atof \
60 atoi \
61 atol\
62 atoll \
63 bsearch \
64 canonicalize \
65 cxa_at_quick_exit \
66 cxa_atexit \
67 cxa_finalize \
68 cxa_thread_atexit_impl \
69 div \
70 drand48 \
71 drand48-iter \
72 drand48_r \
73 erand48 \
74 erand48_r \
75 exit \
76 fmtmsg \
77 getcontext \
78 getentropy \
79 getenv \
80 getrandom \
81 getsubopt \
82 jrand48 \
83 jrand48_r \
84 l64a \
85 labs \
86 lcong48 \
87 lcong48_r \
88 ldiv \
89 llabs \
90 lldiv \
91 lrand48 \
92 lrand48_r \
93 makecontext \
94 mblen \
95 mbstowcs \
96 mbtowc \
97 mrand48 \
98 mrand48_r \
99 msort \
100 nrand48 \
101 nrand48_r \
102 old_atexit \
103 on_exit atexit \
104 putenv \
105 qsort \
106 quick_exit \
107 rand \
108 rand_r \
109 random \
110 random_r \
111 rpmatch \
112 secure-getenv \
113 seed48 \
114 seed48_r \
115 setcontext \
116 setenv \
117 srand48 \
118 srand48_r \
119 strfmon \
120 strfmon_l \
121 strfromd \
122 strfromf \
123 strfroml \
124 strtod \
125 strtod_l \
126 strtod_nan \
127 strtof \
128 strtof_l \
129 strtof_nan \
130 strtol \
131 strtol_l \
132 strtold \
133 strtold_l \
134 strtold_nan \
135 strtoll \
136 strtoll_l \
137 strtoul \
138 strtoul_l \
139 strtoull \
140 strtoull_l \
141 swapcontext \
142 system \
143 wcstombs \
144 wctomb \
145 xpg_basename \
146 # routines
148 aux = \
149 grouping \
150 groupingwc \
151 tens_in_limb \
152 # aux
154 # These routines will be omitted from the libc shared object.
155 # Instead the static object files will be included in a special archive
156 # linked against when the shared library will be used.
157 static-only-routines = \
158 atexit \
159 at_quick_exit \
160 # static-only-routines
162 test-srcs := \
163 tst-fmtmsg \
164 #test-srcs
166 tests := \
167 bug-fmtmsg1 \
168 bug-getcontext \
169 bug-strtod \
170 bug-strtod2 \
171 test-a64l \
172 test-at_quick_exit-race \
173 test-atexit-race \
174 test-bz22786 \
175 test-canon \
176 test-canon2 \
177 test-cxa_atexit-race \
178 test-cxa_atexit-race2 \
179 test-dlclose-exit-race \
180 test-on_exit-race \
181 testdiv \
182 testmb \
183 testmb2 \
184 testrand \
185 testsort \
186 tst-arc4random-fork \
187 tst-arc4random-stats \
188 tst-arc4random-thread \
189 tst-at_quick_exit \
190 tst-atexit \
191 tst-atof1 \
192 tst-atof2 \
193 tst-bsearch \
194 tst-bz20544 \
195 tst-canon-bz26341 \
196 tst-cxa_atexit \
197 tst-environ \
198 tst-getrandom \
199 tst-limits \
200 tst-makecontext \
201 tst-makecontext-align \
202 tst-makecontext2 \
203 tst-makecontext3 \
204 tst-on_exit \
205 tst-qsort \
206 tst-qsort2 \
207 tst-quick_exit \
208 tst-rand48 \
209 tst-rand48-2 \
210 tst-random \
211 tst-random2 \
212 tst-realpath \
213 tst-realpath-toolong \
214 tst-secure-getenv \
215 tst-setcontext \
216 tst-setcontext2 \
217 tst-setcontext3 \
218 tst-setcontext4 \
219 tst-setcontext5 \
220 tst-setcontext6 \
221 tst-setcontext7 \
222 tst-setcontext8 \
223 tst-setcontext9 \
224 tst-strfmon_l \
225 tst-strfrom \
226 tst-strfrom-locale \
227 tst-strtod \
228 tst-strtod-nan-locale \
229 tst-strtod-nan-sign \
230 tst-strtod-overflow \
231 tst-strtod-round \
232 tst-strtod-underflow \
233 tst-strtod2 \
234 tst-strtod5 \
235 tst-strtod6 \
236 tst-strtol \
237 tst-strtol-locale \
238 tst-strtoll \
239 tst-swapcontext1 \
240 tst-thread-quick_exit \
241 tst-tininess \
242 tst-unsetenv1 \
243 tst-width \
244 tst-width-stdint \
245 tst-xpg-basename \
246 # tests
248 tests-internal := \
249 tst-arc4random-chacha20 \
250 tst-strtod1i \
251 tst-strtod3 \
252 tst-strtod4 \
253 tst-strtod5i \
254 tst-tls-atexit \
255 tst-tls-atexit-nodelete \
256 # tests-internal
258 tests-static := \
259 tst-arc4random-chacha20 \
260 tst-secure-getenv \
261 # tests-static
263 tests-container := \
264 tst-system \
265 #tests-container
267 ifeq ($(build-hardcoded-path-in-tests),yes)
268 tests += \
269 tst-empty-env \
270 # tests
271 endif
273 LDLIBS-test-atexit-race = $(shared-thread-library)
274 LDLIBS-test-at_quick_exit-race = $(shared-thread-library)
275 LDLIBS-test-cxa_atexit-race = $(shared-thread-library)
276 LDLIBS-test-cxa_atexit-race2 = $(shared-thread-library)
277 LDLIBS-test-on_exit-race = $(shared-thread-library)
278 LDLIBS-tst-canon-bz26341 = $(shared-thread-library)
279 LDLIBS-tst-arc4random-fork = $(shared-thread-library)
280 LDLIBS-tst-arc4random-thread = $(shared-thread-library)
282 LDLIBS-test-dlclose-exit-race = $(shared-thread-library)
283 LDFLAGS-test-dlclose-exit-race = $(LDFLAGS-rdynamic)
284 LDLIBS-test-dlclose-exit-race-helper.so = $(libsupport) $(shared-thread-library)
286 ifeq ($(have-cxx-thread_local),yes)
287 CFLAGS-tst-quick_exit.o = -std=c++11
288 LDLIBS-tst-quick_exit = -lstdc++
289 CFLAGS-tst-thread-quick_exit.o = -std=c++11
290 LDLIBS-tst-thread-quick_exit = -lstdc++
291 $(objpfx)tst-thread-quick_exit: $(shared-thread-library)
292 else
293 tests-unsupported += \
294 tst-quick_exit \
295 tst-thread-quick_exit \
296 # tests-unsupported
297 endif
299 modules-names = \
300 test-dlclose-exit-race-helper \
301 tst-tls-atexit-lib \
302 # modules-names
303 extra-test-objs += $(addsuffix .os, $(modules-names))
305 ifeq ($(build-shared),yes)
306 tests += \
307 tst-putenv \
308 # tests
309 endif
311 # Several mpn functions from GNU MP are used by the strtod function.
312 mpn-routines := \
313 add_n \
314 addmul_1 \
315 cmp \
316 divmod_1 \
317 divrem \
318 inlines \
319 lshift \
320 mod_1 \
321 mul \
322 mul_1 \
323 mul_n \
324 rshift \
325 sub_n \
326 submul_1 \
327 udiv_qrnnd \
328 # mpn-routines
329 mpn-headers = \
330 asm-syntax.h \
331 gmp-impl.h \
332 gmp-mparam.h \
333 gmp.h \
334 longlong.h \
335 # mpn-headers
337 routines := \
338 $(strip $(routines) $(mpn-routines)) \
339 dbl2mpn \
340 ldbl2mpn \
341 mpn2dbl \
342 mpn2flt \
343 mpn2ldbl \
344 # routines
345 aux += \
346 fpioconst \
347 mp_clz_tab \
348 # aux
350 tests-extras += \
351 tst-putenvmod \
352 # tests-extras
354 extra-test-objs += \
355 tst-putenvmod.os \
356 # extra-test-objs
358 generated += \
359 isomac \
360 isomac.out \
361 tst-putenvmod.so \
362 # generated
364 CFLAGS-bsearch.c += $(uses-callbacks)
365 CFLAGS-msort.c += $(uses-callbacks)
366 CFLAGS-qsort.c += $(uses-callbacks)
367 CFLAGS-system.c += -fexceptions
368 CFLAGS-system.os = -fomit-frame-pointer
369 CFLAGS-fmtmsg.c += -fexceptions
371 CFLAGS-strfmon.c += $(libio-mtsafe)
372 CFLAGS-strfmon_l.c += $(libio-mtsafe)
374 # The strfrom class of functions call __printf_fp in order to convert the
375 # floating-point value to characters. This requires the value of IO_MTSAFE_IO.
376 CFLAGS-strfromd.c += $(libio-mtsafe)
377 CFLAGS-strfromf.c += $(libio-mtsafe)
378 CFLAGS-strfroml.c += $(libio-mtsafe)
380 CFLAGS-tst-bsearch.c += $(stack-align-test-flags)
381 CFLAGS-tst-qsort.c += $(stack-align-test-flags)
382 CFLAGS-tst-makecontext.c += -funwind-tables
383 CFLAGS-tst-makecontext2.c += $(stack-align-test-flags)
385 CFLAGS-testmb.c += -D_FORTIFY_SOURCE=2 -Wall -Werror
388 # Run a test on the header files we use.
389 tests-special += $(objpfx)isomac.out
391 ifeq ($(run-built-tests),yes)
392 tests-special += $(objpfx)tst-fmtmsg.out
393 endif
395 include ../Rules
397 ifeq ($(run-built-tests),yes)
398 LOCALES := \
399 cs_CZ.UTF-8 \
400 de_DE.UTF-8 \
401 el_GR.UTF-8 \
402 en_US.ISO-8859-1 \
403 hi_IN.UTF-8 \
404 hr_HR.UTF-8 \
405 tg_TJ.UTF-8 \
406 tr_TR.ISO-8859-9 \
407 tr_TR.UTF-8 \
408 # LOCALES
409 include ../gen-locales.mk
411 $(objpfx)bug-strtod2.out: $(gen-locales)
412 $(objpfx)testmb2.out: $(gen-locales)
413 $(objpfx)tst-strtod.out: $(gen-locales)
414 $(objpfx)tst-strtod1i.out: $(gen-locales)
415 $(objpfx)tst-strtod3.out: $(gen-locales)
416 $(objpfx)tst-strtod4.out: $(gen-locales)
417 $(objpfx)tst-strtod5.out: $(gen-locales)
418 $(objpfx)tst-strtod5i.out: $(gen-locales)
419 $(objpfx)tst-strtol-locale.out: $(gen-locales)
420 $(objpfx)tst-strtod-nan-locale.out: $(gen-locales)
421 $(objpfx)tst-strfmon_l.out: $(gen-locales)
422 $(objpfx)tst-strfrom.out: $(gen-locales)
423 $(objpfx)tst-strfrom-locale.out: $(gen-locales)
424 $(objpfx)test-dlclose-exit-race.out: $(objpfx)test-dlclose-exit-race-helper.so
425 endif
427 # Testdir has to be named stdlib and needs to be writable
428 test-canon-ARGS = --test-dir=${common-objpfx}stdlib
430 bug-fmtmsg1-ENV = SEV_LEVEL=foo,11,newsev
432 $(objpfx)isomac.out: $(objpfx)isomac
433 $(dir $<)$(notdir $<) '$(CC)' \
434 '-I../include $(+sysdep-includes) $(sysincludes) -I..' > $@; \
435 $(evaluate-test)
437 isomac-CFLAGS = -O
438 $(objpfx)isomac: isomac.c
439 $(native-compile)
441 $(objpfx)tst-fmtmsg.out: tst-fmtmsg.sh $(objpfx)tst-fmtmsg
442 $(SHELL) $< $(common-objpfx) '$(test-program-prefix-before-env)' \
443 '$(run-program-env)' '$(test-program-prefix-after-env)' \
444 $(common-objpfx)stdlib/; \
445 $(evaluate-test)
447 $(objpfx)tst-putenv: $(objpfx)tst-putenvmod.so
448 LDFLAGS-tst-putenv = -Wl,--no-as-needed
450 $(objpfx)tst-putenvmod.so: $(objpfx)tst-putenvmod.os $(link-libc-deps)
451 $(build-module)
452 libof-tst-putenvmod = extramodules
454 $(objpfx)bug-getcontext: $(libm)
455 $(objpfx)bug-strtod2: $(libm)
456 $(objpfx)tst-strtod-round: $(libm)
457 $(objpfx)tst-tininess: $(libm)
458 $(objpfx)tst-strtod-underflow: $(libm)
459 $(objpfx)tst-strtod6: $(libm)
460 $(objpfx)tst-strtod-nan-locale: $(libm)
461 $(objpfx)tst-strtod-nan-sign: $(libm)
463 tst-tls-atexit-lib.so-no-z-defs = yes
464 test-dlclose-exit-race-helper.so-no-z-defs = yes
466 $(objpfx)tst-tls-atexit: $(shared-thread-library)
467 $(objpfx)tst-tls-atexit.out: $(objpfx)tst-tls-atexit-lib.so
469 $(objpfx)tst-tls-atexit-nodelete: $(shared-thread-library)
470 $(objpfx)tst-tls-atexit-nodelete.out: $(objpfx)tst-tls-atexit-lib.so
472 $(objpfx)tst-setcontext3.out: tst-setcontext3.sh $(objpfx)tst-setcontext3
473 $(SHELL) $< $(common-objpfx) '$(test-program-prefix-before-env)' \
474 '$(run-program-env)' '$(test-program-prefix-after-env)' \
475 $(common-objpfx)stdlib/; \
476 $(evaluate-test)