thread_safety(5)

NAME

thread_safety — list of libc, libpthread and libgen interfaces that are: Not Thread-Safe, Cancellation Points, Cancel Safe, Async Signal Safe, or Async Cancel Safe

DESCRIPTION

Refer to this manpage when writing thread-safe applications using libc, libpthread and libgen interfaces. This manpage gives the list of libc, libpthread and libgen interfaces that are: Not Thread-Safe, Cancellation Points, Cancel Safe, Async Signal Safe, or Async Cancel Safe.

Interfaces That Are Not Thread-Safe

All the interfaces are thread-safe except:

`bgets()`	`bufsplit()`	`copylist()`
`dbmclose()`	`dbminit()`	`delete()`
`endmntent()`	`fattach()`	`fdetach()`
`fetch()`	`firstkey()`	`getc_unlocked()`
`getchar_unlocked()`	`getcontext()`	`getopt()`
`inet_ntop()`	`inet_pton()`	`isastream()`
`makecontext()`	`memcntl()`	`nextkey()`
`putc_unlocked()`	`putchar_unlocked()`	`setcontext()`
`setmntent()`	`store()`	`strord()`
`strtold()`	`system()`	`swapcontext()`

NOTE: If an interface has a _r counterpart, then the _r interface is thread-safe, and the non-_r is not thread-safe.

Cancellation Points

Cancellation Points can occur when a thread is executing in the following interfaces:

`_pututline()`	`accept()`	`aio_suspend()`
`bgets()`	`bwtmpname()`	`catclose()`
`catgets()`	`catopen()`	`close()`
`closedir()`	`closelog()`	`confstr()`
`connect()`	`copylist()`	`creat()`
`ctermid()`	`cuserid()`	`dbm_close()`
`dbm_delete()`	`dbm_fetch()`	`dbm_firstkey()`
`dbm_nextkey()`	`dbm_open()`	`dbm_store()`
`devnm()`	`dial()`	`endbwent()`
`endgrent()`	`endpwent()`	`endusershell()`
`endutent()`	`endutsent()`	`endutxent()`
`fclose()`	`fcntl()`	`fdopen()`
`fflush()`	`fgetc()`	`fgetpos()`
`fgetpwent()`	`fgets()`	`fgetwc()`
`fgetws()`	`flock()`	`fopen()`
`fprintf()`	`fputc()`	`fputs()`
`fputwc()`	`fputws()`	`fread()`
`freopen()`	`fscanf()`	`fseek()`
`fseeko()`	`fsetpos()`	`fstatvfsdev()`
`fsync()`	`ftell()`	`ftello()`
`ftw()`	`fwprintf()`	`fwrite()`
`fwscanf()`	`getbwent()`	`getc()`
`getc_unlocked()`	`getchar()`	`getchar_unlocked()`
`getcwd()`	`getdate()`	`getgrent()`
`getgrgid()`	`getgrgid_r()`	`getgrnam()`
`getgrnam_r()`	`getlogin()`	`getlogin_r()`
`getmsg()`	`getpmsg()`	`getpwent()`
`getpwnam()`	`getpwnam_r()`	`getpwuid()`
`getpwuid_r()`	`gets()`	`gettxt()`
`getusershell()`	`getutent()`	`getutid()`
`getutline()`	`getutxent()`	`getutsent()`
`getutsid()`	`getutsline()`	`getutspid()`
`getutxid()`	`getutxline()`	`getw()`
`getwc()`	`getwchar()`	`getwd()`
`glob()`	`globfree()`	`iconv()`
`iconv_close()`	`iconv_open()`	`initgroups()`
`insque()`	`ioctl()`	`isastream()`
`lckpwdf()`	`lockf()`	`lockf64()`
`lseek()`	`lseek64()`	`mkstemp()`
`msgrcv()`	`msgsnd()`	`msync()`
`nanosleep()`	`nftw()`	`nftw2()`
`open()`	`opendir()`	`openlog()`
`pause()`	`pclose()`	`perror()`
`pfmt()`	`poll()`	`popen()`
`pread()`	`printf()`	`pselect()`
`pthread_cond_timedwait()`	`pthread_cond_wait()`	`pthread_join()`
`pthread_testcancel()`	`putc()`	`putc_unlocked()`
`putchar()`	`putchar_unlocked()`	`putmsg()`
`putpmsg()`	`putpwent()`	`puts()`
`pututline()`	`pututsline()`	`pututxline()`
`putw()`	`putwc()`	`putwchar()`
`putws()`	`pwrite()`	`read()`
`readdir()`	`readdir_r()`	`readv()`
`recv()`	`recvfrom()`	`recvmsg()`
`remove()`	`remque()`	`rename()`
`rewind()`	`rewinddir()`	`scandir()`
`scanf()`	`seekdir()`	`select()`
`semop()`	`send()`	`sendmsg()`
`sendto()`	`sendfile()`	`setbwent()`
`setgrent()`	`setpwent()`	`setusershell()`
`setutent()`	`setutsent()`	`setutxent()`
`sigpause()`	`sigsuspend()`	`sigtimedwait()`
`sigwait()`	`sigwaitinfo()`	`sleep()`
`socket()`	`socketpair()`	`statvfsdev()`
`strerror()`	`syslog()`	`system()`
`t_accept()`	`t_alloc()`	`t_bind()`
`t_close()`	`t_connect()`	`t_error()`
`t_getinfo()`	`t_getprotaddr()`	`t_getstate()`
`t_listen()`	`t_look()`	`t_open()`
`t_optmgmt()`	`t_rcv()`	`t_rcvconnect()`
`t_rcvdis()`	`t_rcvrel()`	`t_rcvudata()`
`t_rcvuderr()`	`t_snd()`	`t_snddis()`
`t_sndrel()`	`t_sndudata()`	`t_strerror()`
`t_sync()`	`t_unbind()`	`tcdrain()`
`tmpfile()`	`tmpnam()`	`ttyname()`
`ttyname_r()`	`ttyslot()`	`ulckpwdf()`
`undial()`	`ungetc()`	`ungetwc()`
`unlink()`	`updatebwdb()`	`usleep()`
`utmpname()`	`vfprintf()`	`vfscanf()`
`vfwprintf()`	`vpfmt()`	`vprintf()`
`vscanf()`	`vwprintf()`	`wait()`
`wait3()`	`waitid()`	`waitpid()`
`wordexp()`	`wordfree()`	`wprintf()`
`write()`	`writev()`	`wscanf()`

NOTE: A cancellation point WILL NOT occur when a thread is executing in isastream() in a UNIX 2003 conformant application.

Cancel Safe

All the following interfaces are Cancel Safe:

`accept()`	`bind()`	`connect()`	`dn_comp()`
`dn_expand()`	`endhostent()`	`endnetent()`	`endprotoent()`
`endservent()`	`get_resfield()`	`gethostbyaddr()`	`gethostbyname()`
`gethostent()`	`getmsg()`	`getnetbyaddr()`	`getnetbyname()`
`getnetent()`	`getpeername()`	`getpmsg()`	`getprotobyname()`
`getprotobynumber()`	`getprotoent()`	`getservbyname()`	`getservbyport()`
`getservent()`	`getsockname()`	`getsockopt()`	`herror()`
`inet_addr()`	`inet_lnaof()`	`inet_makeaddr()`	`inet_netof()`
`inet_network()`	`inet_ntoa()`	`isastream()`	`listen()`
`msync()`	`net_aton()`	`net_ntoa()`	`poll()`
`putmsg()`	`putpmsg()`	`rcmd()`	`recv()`
`recvfrom()`	`recvmsg()`	`res_init()`	`res_mkquery()`
`res_query()`	`res_search()`	`res_send()`	`rexec()`
`rresvport()`	`ruserok()`	`sbrk()`	`send()`
`sendfile()`	`sendmsg()`	`sendto()`	`set_resfield()`
`sethostent()`	`setnetent()`	`setprotoent()`	`setservent()`
`setsockopt()`	`shutdown()`	`socket()`	`socketpair()`

Async Signal Safe

All the following interfaces are Async Signal Safe:

`_exit()`	`accept()`	`access()`	`alarm()`
`bind()`	`cfgetispeed()`	`cfgetospeed()`	`cfsetispeed()`
`cfsetospeed()`	`chdir()`	`chmod()`	`chown()`
`close()`	`connect()`	`creat()`	`dup()`
`dup2()`	`execle()`	`execve()`	`fcntl()`
`flock()`	`fpathconf()`	`fstat()`	`getegid()`
`geteuid()`	`getgid()`	`getgroups()`	`getmsg()`
`getpeername()`	`getpgrp()`	`getpid()`	`getpmsg()`
`getppid()`	`getsockname()`	`getsockopt()`	`getuid()`
`isastream()`	`kill()`	`link()`	`listen()`
`lseek()`	`memset()`	`mkdir()`	`mkfifo()`
`msync()`	`net_aton()`	`net_ntoa()`	`open()`
`pathconf()`	`pause()`	`pipe()`	`poll()`
`putmsg()`	`putpmsg()`	`raise()`	`read()`
`recv()`	`recvfrom()`	`recvmsg()`	`rename()`
`rmdir()`	`send()`	`sendfile()`	`sendmsg()`
`sendto()`	`setgid()`	`setpgid()`	`setsid()`
`setsockopt()`	`setuid()`	`shutdown()`	`sigaction()`
`sigaddset()`	`sigdelset()`	`sigemptyset()`	`sigfillset()`
`sigismember()`	`signal()`	`sigpending()`	`sigprocmask()`
`sigqueue()`	`sigsuspend()`	`sleep()`	`socket()`
`socketpair()`	`stat()`	`sysconf()`	`tcdrain()`
`tcflow()`	`tcflush()`	`tcgetattr()`	`tcgetpgrp()`
`tcsendbreak()`	`tcsetattr()`	`tcsetpgrp()`	`time()`
`times()`	`umask()`	`uname()`	`unlink()`
`utime()`	`wait()`	`waitpid()`	`write()`

NOTE: isastream() is not Async Signal Safe in a UNIX 2003 conformant application.

Async Cancel Safe

All the following interfaces are Async Cancel Safe:

`a64l()`	`abs()`	`accept()`
`addmntent()`	`atof()`	`atoi()`
`atol()`	`bcmp()`	`bcopy()`
`bind()`	`bsearch()`	`bzero()`
`cfgetispeed()`	`cfgetospeed()`	`cfsetispeed()`
`cfsetospeed()`	`connect()`	`div()`
`execv()`	`execve()`	`ffs()`
`fnmatch()`	`fsetaclentry()`	`ftok()`
`getclock()`	`getmsg()`	`getpeername()`
`getpmsg()`	`getrlimit()`	`getsockname()`
`getsockopt()`	`getsubopt()`	`index()`
`insque()`	`isalnum()`	`isalpha()`
`isascii()`	`isastream()`	`iscntrl()`
`isdigit()`	`isgraph()`	`islower()`
`isprint()`	`ispunct()`	`isspace()`
`isupper()`	`iswalnum()`	`iswalpha()`
`iswcntrl()`	`iswctype()`	`iswdigit()`
`iswgraph()`	`iswlower()`	`iswprint()`
`iswpunct()`	`iswspace()`	`iswupper()`
`iswxdigit()`	`isxdigit()`	`l3tol()`
`labs()`	`ldiv()`	`lfind()`
`listen()`	`lsearch()`	`ltol3()`
`mblen()`	`mbstowcs()`	`mbtowc()`
`memccpy()`	`memchr()`	`memcmp()`
`memcpy()`	`memmove()`	`memset()`
`mkfifo()`	`mktemp()`	`msem_init()`
`msem_lock()`	`msgrcv()`	`msgsnd()`
`msync()`	`nanosleep()`	`net_aton()`
`net_ntoa()`	`pathfind()`	`pause()`
`poll()`	`pstat()`	`pstat_getlwp()`
`pthread_cancel()`	`pthread_setcancelstate()`	`pthread_setcanceltype()`
`putmsg()`	`putpmsg()`	`recv()`
`recvfrom()`	`recvmsg()`	`remque()`
`rindex()`	`rmdirp()`	`sbrk()`
`semop()`	`send()`	`sendfile()`
`sendmsg()`	`sendto()`	`setaclentry()`
`setcat()`	`setclock()`	`setrlimit()`
`setsockopt()`	`shutdown()`	`sigsuspend()`
`socket()`	`socketpair()`	`strcasecmp()`
`strcat()`	`strchr()`	`strcmp()`
`strcoll()`	`strcpy()`	`strcspn()`
`strdup()`	`strlen()`	`strncasecmp()`
`strncat()`	`strncmp()`	`strncpy()`
`strord()`	`strpbrk()`	`strrchr()`
`strrstr()`	`strspn()`	`strstr()`
`strtod()`	`strtok_r()`	`strtol()`
`strtold()`	`strtoul()`	`strxfrm()`
`swab()`	`tcdrain()`	`tcflow()`
`tcflush()`	`tcgetattr()`	`tcgetpgrp()`
`tcgetsid()`	`tcsendbreak()`	`tcsetattr()`
`tcsetpgrp()`	`toascii()`	`tolower()`
`toupper()`	`towlower()`	`towupper()`
`ulimit()`	`wait()`	`wait3()`
`waitid()`	`wcscat()`	`wcschr()`
`wcscmp()`	`wcscpy()`	`wcscspn()`
`wcslen()`	`wcsncat()`	`wcsncmp()`
`wcsncpy()`	`wcspbrk()`	`wcsrchr()`
`wcsspn()`	`wcsstr()`	`wcstod()`
`wcstok()`	`wcstol()`	`wcstombs()`
`wcstoul()`	`wcswcs()`	`wctomb()`
`wctype()`

thread_safety(5)

Technical documentation

» Table of Contents

» Index