samba-mirror

mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00

History

Pavel Filipenský 8564380346 lib:replace: Add macro BURN_STR() to zero memory of a string Signed-off-by: Pavel Filipenský <pfilipensky@samba.org> Reviewed-by: Andreas Schneider <asn@samba.org>		2022-08-26 07:59:32 +00:00
..
system	lib/replace: add a replacement for openat2() that returns ENOSYS	2022-08-15 15:03:36 +00:00
tests	lib:replace: Fix NULL issue reported by covscan	2022-02-01 21:09:21 +00:00
.checker_innocent
closefrom.c	libreplace: Compare a pointer against NULL, not 0	2020-11-04 18:55:39 +00:00
configure	configure/Makefile: export PYTHONHASHSEED=1 in all 'configure/Makefile' scripts	2022-03-29 22:32:32 +00:00
dlfcn.c
getaddrinfo.c
getaddrinfo.h
getifaddrs.c	replace: Use #ifdef instead of #if for config.h definitions	2018-11-28 23:19:21 +01:00
hdr_replace.h
inet_aton.c
inet_ntoa.c
inet_ntop.c
inet_pton.c
Makefile	build: Move python detection back into waf (instead of in configure and Makefile)	2018-12-14 14:40:19 +01:00
poll.c
README	replace: Add memset_s to replacement functions	2018-12-20 12:16:39 +01:00
replace-test.h
replace-testsuite.h
replace.c	lib/replace: let DISABLE_OPATH also undef __NR_openat2	2022-08-15 15:03:37 +00:00
replace.h	lib:replace: Add macro BURN_STR() to zero memory of a string	2022-08-26 07:59:32 +00:00
snprintf.c	lib: replace: snprintf: Whitespace clean up	2019-01-10 06:15:21 +01:00
socket.c
socketpair.c
strptime.c	lib:replace: Add FALL_THROUGH statements in strptime.c	2018-03-01 04:37:41 +01:00
timegm.c	lib/replace/timegm: use utf-8	2021-11-17 05:27:39 +00:00
win32_replace.h
wscript	lib/replace: add a replacement for openat2() that returns ENOSYS	2022-08-15 15:03:36 +00:00
xattr.c	lib: Align an integer type	2022-08-04 20:44:32 +00:00

README

This subsystem ensures that we can always use a certain core set of 
functions and types, that are either provided by the OS or by replacement 
functions / definitions in this subsystem. The aim is to try to stick 
to POSIX functions in here as much as possible. Convenience functions 
that are available on no platform at all belong in other subsystems
(such as LIBUTIL).

The following functions are guaranteed:

ftruncate
strlcpy
strlcat
mktime
rename
initgroups
memmove
strdup
setlinebuf
vsyslog
timegm
setenv
unsetenv
strndup
strnlen
waitpid
seteuid
setegid
asprintf
snprintf
vasprintf
vsnprintf
opendir
readdir
telldir
seekdir
clock_gettime
closedir
dlopen
dlclose
dlsym
dlerror
chroot
bzero
strerror
errno
mkdtemp
mkstemp (a secure one!)
pread
pwrite
chown
lchown
readline (the library)
inet_ntoa
inet_ntop
inet_pton
inet_aton
strtoll
strtoull
socketpair
strptime
getaddrinfo
freeaddrinfo
getnameinfo
gai_strerror
getifaddrs
freeifaddrs
utime
utimes
dup2
link
readlink
symlink
realpath
poll
setproctitle
memset_s

Types:
bool
socklen_t
uint{8,16,32,64}_t
int{8,16,32,64}_t
intptr_t
sig_atomic_t
blksize_t
blkcnt_t

Constants:
PATH_NAME_MAX
UINT{16,32,64}_MAX
INT32_MAX
RTLD_LAZY
HOST_NAME_MAX
UINT16_MAX
UINT32_MAX
UINT64_MAX
CHAR_BIT

Macros:
va_copy
__FUNCTION__
__FILE__
__LINE__
__LINESTR__
__location__
__STRING
__STRINGSTRING
MIN
MAX
QSORT_CAST
ZERO_STRUCT
ZERO_STRUCTP
ZERO_STRUCTPN
ZERO_ARRAY
ARRAY_SIZE
PTR_DIFF

Headers:
stdint.h
stdbool.h

Optional C keywords:
volatile

Prerequisites:
memset (for bzero)
syslog (for vsyslog)
mktemp (for mkstemp and mkdtemp)