diff options
Diffstat (limited to 'man7/attributes.7')
| -rw-r--r-- | man7/attributes.7 | 20 |
1 files changed, 11 insertions, 9 deletions
diff --git a/man7/attributes.7 b/man7/attributes.7 index 3b2f59b3a..e2403e844 100644 --- a/man7/attributes.7 +++ b/man7/attributes.7 @@ -565,9 +565,9 @@ Functions marked with .I term as an MT-Safety issue may change the terminal settings in the recommended way, namely: call -.BR tcgetattr (3), +.MR tcgetattr 3 , modify some flags, and then call -.BR tcsetattr (3), +.MR tcsetattr 3 , this creates a window in which changes made by other threads are lost. Thus, functions marked with .I term @@ -655,7 +655,7 @@ Functions marked with .I env as an MT-Safety issue access the environment with -.BR getenv (3) +.MR getenv 3 or similar, without any guards to ensure safety in the presence of concurrent modifications. .IP @@ -678,10 +678,12 @@ hold the "host ID" of the machine. These data structures cannot generally be modified atomically. Since it is expected that the "host ID" will not normally change, the function that reads from it -.RB ( gethostid (3)) +\%(\c +.MR gethostid 3 ) is regarded as safe, whereas the function that modifies it -.RB ( sethostid (3)) +\%(\c +.MR sethostid 3 ) is marked with .IR const:hostid , indicating it may require special care if it is to be called. @@ -782,12 +784,12 @@ other threads or within asynchronous signal or cancelation handlers. This is not enough of a reason to mark so-marked functions as MT-Unsafe, .\" or AS-Unsafe, but when this behavior is optional (e.g., -.BR nftw (3) +.MR nftw 3 with .BR FTW_CHDIR ), avoiding the option may be a good alternative to using full pathnames or file descriptor-relative (e.g., -.BR openat (2)) +.MR openat 2 ) system calls. .\" .TP .\" .I !posix @@ -861,5 +863,5 @@ adorned with such conditions, and none of the named conditions hold, then the function can be regarded as safe. .SH SEE ALSO -.BR pthreads (7), -.BR signal\-safety (7) +.MR pthreads 7 , +.MR signal\-safety 7 |