From: Brian Inglis <Brian.Inglis@SystematicSW.ab.ca>
To: cygwin.patches@cygwin.com, cygwin-patches@cygwin.com
Subject: [PATCH v2] winsup/doc/posix.xml: add note for getrlimit, setrlimit, xrefs to notes
Date: Mon, 15 Feb 2021 15:35:39 -0700 [thread overview]
Message-ID: <20210215223540.18256-1-Brian.Inglis@SystematicSW.ab.ca> (raw)
[-- Attachment #1: Type: text/plain, Size: 316 bytes --]
change notes to see "Implementation Notes" to xref to std-notes;
add xref to std-notes to getrlimit, setrlimit;
add note to document limitations of getrlimit, setrlimit resources support
---
winsup/doc/posix.xml | 101 ++++++++++++++++++++++++-------------------
1 file changed, 57 insertions(+), 44 deletions(-)
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-winsup-doc-posix.xml-add-note-for-getrlimit-setrlimit.patch --]
[-- Type: text/x-patch; name="0001-winsup-doc-posix.xml-add-note-for-getrlimit-setrlimit.patch", Size: 11249 bytes --]
diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml
index 0669d07de890..360ee703f3dd 100644
--- a/winsup/doc/posix.xml
+++ b/winsup/doc/posix.xml
@@ -64,7 +64,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
atoi
atol
atoll
- basename (see chapter "Implementation Notes")
+ basename <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
bind
bsearch
btowc
@@ -126,8 +126,8 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
clock_getcpuclockid
clock_getres
clock_gettime
- clock_nanosleep (see chapter "Implementation Notes")
- clock_settime (see chapter "Implementation Notes")
+ clock_nanosleep <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ clock_settime <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
clog
clogf
clogl
@@ -242,7 +242,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
fchown
fchownat
fclose
- fcntl (see chapter "Implementation Notes")
+ fcntl <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
fdatasync
fdim
fdimf
@@ -292,7 +292,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
fopen
fork
fpathconf
- fpclassify (see chapter "Implementation Notes")
+ fpclassify <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
fprintf
fputc
fputs
@@ -347,7 +347,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
getgroups
gethostid
gethostname
- getitimer (see chapter "Implementation Notes")
+ getitimer <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
getline
getlogin
getlogin_r
@@ -367,7 +367,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
getpwnam_r
getpwuid
getpwuid_r
- getrlimit
+ getrlimit <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
getrusage
gets
getservbyname
@@ -428,26 +428,26 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
iscntrl_l
isdigit
isdigit_l
- isfinite (see chapter "Implementation Notes")
+ isfinite <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
isgraph
isgraph_l
- isgreater (see chapter "Implementation Notes")
- isgreaterequal (see chapter "Implementation Notes")
- isinf (see chapter "Implementation Notes")
+ isgreater <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ isgreaterequal <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ isinf <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
isless
- islessequal (see chapter "Implementation Notes")
- islessgreater (see chapter "Implementation Notes")
+ islessequal <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ islessgreater <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
islower
islower_l
- isnan (see chapter "Implementation Notes")
- isnormal (see chapter "Implementation Notes")
+ isnan <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ isnormal <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
isprint
isprint_l
ispunct
ispunct_l
isspace
isspace_l
- isunordered (see chapter "Implementation Notes")
+ isunordered <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
isupper
isupper_l
iswalnum
@@ -511,7 +511,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
localeconv
localtime
localtime_r
- lockf (see chapter "Implementation Notes")
+ lockf <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
log
log10
log10f
@@ -579,10 +579,10 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
mq_timedsend
mq_unlink
mrand48
- msgctl (see chapter "Implementation Notes")
- msgget (see chapter "Implementation Notes")
- msgrcv (see chapter "Implementation Notes")
- msgsnd (see chapter "Implementation Notes")
+ msgctl <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ msgget <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ msgrcv <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ msgsnd <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
msync
munlock
munmap
@@ -834,9 +834,9 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
sem_trywait
sem_unlink
sem_wait
- semctl (see chapter "Implementation Notes")
- semget (see chapter "Implementation Notes")
- semop (see chapter "Implementation Notes")
+ semctl <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ semget <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ semop <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
send
sendmsg
sendto
@@ -847,7 +847,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
setgid
setgrent
sethostent
- setitimer (see chapter "Implementation Notes")
+ setitimer <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
setjmp
setkey (available in external "crypt" library)
setlocale
@@ -859,7 +859,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
setpwent
setregid
setreuid
- setrlimit
+ setrlimit <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
setservent
setsid
setsockopt
@@ -869,10 +869,10 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
setvbuf
shm_open
shm_unlink
- shmat (see chapter "Implementation Notes")
- shmctl (see chapter "Implementation Notes")
- shmdt (see chapter "Implementation Notes")
- shmget (see chapter "Implementation Notes")
+ shmat <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ shmctl <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ shmdt <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ shmget <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
shutdown
sigaction
sigaddset
@@ -886,9 +886,9 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
sigismember
siglongjmp
signal
- signbit (see chapter "Implementation Notes")
+ signbit <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
signgam
- sigpause (see chapter "Implementation Notes")
+ sigpause <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
sigpending
sigprocmask
sigqueue
@@ -937,7 +937,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
strdup
strerror
strerror_l
- strerror_r (see chapter "Implementation Notes")
+ strerror_r <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
strfmon
strfmon_l
strftime
@@ -1001,7 +1001,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
tgammaf
tgammal
time
- timer_create (see chapter "Implementation Notes")
+ timer_create <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
timer_delete
timer_getoverrun
timer_gettime
@@ -1162,7 +1162,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
finitef
finitel
fiprintf
- flock (see chapter "Implementation Notes")
+ flock <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
fls
flsl
flsll
@@ -1212,7 +1212,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
madvise
mkstemps
openpty
- qsort_r (see chapter "Implementation Notes")
+ qsort_r <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
rcmd
rcmd_af
reallocarray
@@ -1257,7 +1257,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
valloc
verr
verrx
- vhangup (see chapter "Implementation Notes")
+ vhangup <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
vsyslog
vwarn
vwarnx
@@ -1291,14 +1291,14 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
asnprintf
asprintf
asprintf_r
- basename (see chapter "Implementation Notes")
+ basename <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
canonicalize_file_name
clearenv
clog10
clog10f
clog10l
crypt_r (available in external "crypt" library)
- dladdr (see chapter "Implementation Notes")
+ dladdr <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
dremf
dup3
envz_add
@@ -1370,8 +1370,8 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
ptsname_r
putwc_unlocked
putwchar_unlocked
- renameat2 (see chapter "Implementation Notes")
- qsort_r (see chapter "Implementation Notes")
+ renameat2 <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ qsort_r <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
quotactl
rawmemchr
removexattr
@@ -1545,8 +1545,8 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
bcmp (POSIX.1-2001, SUSv3)
bcopy (SUSv3)
bzero (SUSv3)
- chroot (SUSv2) (see chapter "Implementation Notes")
- clock_setres (QNX, VxWorks) (see chapter "Implementation Notes")
+ chroot (SUSv2) <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
+ clock_setres (QNX, VxWorks) <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
cuserid (POSIX.1-1988, SUSv2)
ecvt (SUSv3)
endutent (XPG2)
@@ -1592,7 +1592,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
ualarm (SUSv3)
usleep (SUSv3)
utmpname (XPG2)
- vfork (SUSv3) (see chapter "Implementation Notes")
+ vfork (SUSv3) <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
</screen>
</sect1>
@@ -1727,6 +1727,19 @@ flavors, depending on whether _GNU_SOURCE is defined when compiling.</para>
<para><function>dladdr</function> always sets the Dl_info members dli_sname and
dli_saddr to NULL, indicating no symbol matching addr could be found.</para>
+<para><function>getrlimit</function> resources RLIMIT_AS, RLIMIT_CPU,
+RLIMIT_FSIZE, RLIMIT_DATA always return rlim_cur and rlim_max as RLIM_INFINITY,
+so <function>setrlimit</function> returns -1 and sets EINVAL if they are
+lowered, or returns 0 if unchanged.
+<function>getrlimit</function> resource RLIMIT_NOFILE always returns rlim_cur
+and rlim_max as OPEN_MAX; <function>setrlimit</function> returns 0 sets EINVAL
+if rlim_cur > rlim_max, does not change the value if it is RLIM_INFINITY,
+otherwise returns the result from <function>setdtablesize</function>.
+<function>getrlimit</function>/<function>setrlimit</function> resources
+RLIMIT_CORE and RLIMIT_STACK return the current values and set the requested
+values.
+All other resource arguments return -1 and set EINVAL.</para>
+
</sect1>
</chapter>
next reply other threads:[~2021-02-15 22:35 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-02-15 22:35 Brian Inglis [this message]
2021-02-16 11:30 ` Corinna Vinschen
2021-02-16 16:51 ` Brian Inglis
2021-02-16 17:00 ` Brian Inglis
2021-02-17 9:29 ` Corinna Vinschen
2021-02-17 15:51 ` Brian Inglis
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210215223540.18256-1-Brian.Inglis@SystematicSW.ab.ca \
--to=brian.inglis@systematicsw.ab.ca \
--cc=cygwin-patches@cygwin.com \
--cc=cygwin.patches@cygwin.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).