r23118: Make inet_pton and inet_ntop available through lib/replace.
[jelmer/samba4-debian.git] / source / lib / replace / README
1 This subsystem ensures that we can always use a certain core set of 
2 functions and types, that are either provided by the OS or by replacement 
3 functions / definitions in this subsystem. The aim is to try to stick 
4 to POSIX functions in here as much as possible. Convenience functions 
5 that are available on no platform at all belong in other subsystems
6 (such as LIBUTIL).
7
8 The following functions are guaranteed:
9
10 ftruncate
11 strlcpy
12 strlcat
13 mktime
14 rename
15 initgroups
16 memmove
17 strdup
18 inet_ntoa
19 setlinebuf
20 vsyslog
21 timegm
22 setenv
23 unsetenv
24 strndup
25 strnlen
26 waitpid
27 seteuid
28 setegid
29 asprintf
30 snprintf
31 vasprintf
32 vsnprintf
33 opendir
34 readdir
35 telldir
36 seekdir
37 closedir
38 dlopen
39 dlclose
40 dlsym
41 dlerror
42 chroot
43 bzero
44 strerror
45 errno
46 mkdtemp
47 mkstemp (a secure one!)
48 pread
49 pwrite
50 getpass
51 readline (the library)
52 inet_ntoa
53 strtoll
54 strtoull
55 socketpair
56 strptime
57 inet_pton
58 inet_ntop
59
60 Types:
61 bool
62 socklen_t
63 uint_t
64 uint{8,16,32,64}_t
65 int{8,16,32,64}_t
66 intptr_t
67
68 Constants:
69 PATH_NAME_MAX
70 UINT{16,32,64}_MAX
71 INT32_MAX
72 RTLD_LAZY
73 HOST_NAME_MAX
74 UINT16_MAX
75 UINT32_MAX
76 UINT64_MAX
77 CHAR_BIT
78
79 Macros:
80 va_copy
81 __FUNCTION__
82 __FILE__
83 __LINE__
84 __LINESTR__
85 __location__
86 __STRING
87 __STRINGSTRING
88 MIN
89 MAX
90 QSORT_CAST
91 ZERO_STRUCT
92 ZERO_STRUCTP
93 ZERO_STRUCTPN
94 ZERO_ARRAY
95 ARRAY_SIZE
96 PTR_DIFF
97
98 Headers:
99 stdint.h
100 stdbool.h
101
102 Prerequisites:
103 memset (for bzero)
104 syslog (for vsyslog)
105 mktemp (for mkstemp and mkdtemp)