public inbox for cygwin-cvs@sourceware.org help / color / mirror / Atom feed
From: Corinna Vinschen <corinna@sourceware.org> To: cygwin-cvs@sourceware.org Subject: [newlib-cygwin] winsup/doc/posix.xml: add note for getrlimit, setrlimit, xrefs to notes Date: Tue, 16 Feb 2021 11:28:31 +0000 (GMT) [thread overview] Message-ID: <20210216112831.52E643854830@sourceware.org> (raw) https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=2caca30309eae73fef4bf14af947ad9cc9551eeb commit 2caca30309eae73fef4bf14af947ad9cc9551eeb Author: Brian Inglis <Brian.Inglis@SystematicSW.ab.ca> Date: Mon Feb 15 15:35:39 2021 -0700 winsup/doc/posix.xml: add note for getrlimit, setrlimit, xrefs to notes 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 Diff: --- winsup/doc/posix.xml | 101 +++++++++++++++++++++++++++++---------------------- 1 file changed, 57 insertions(+), 44 deletions(-) diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml index 0669d07de..48ab7dbc9 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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + clock_settime (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) isgraph isgraph_l - isgreater (see chapter "Implementation Notes") - isgreaterequal (see chapter "Implementation Notes") - isinf (see chapter "Implementation Notes") + isgreater (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + isgreaterequal (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + isinf (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) isless - islessequal (see chapter "Implementation Notes") - islessgreater (see chapter "Implementation Notes") + islessequal (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + islessgreater (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) islower islower_l - isnan (see chapter "Implementation Notes") - isnormal (see chapter "Implementation Notes") + isnan (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + isnormal (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) isprint isprint_l ispunct ispunct_l isspace isspace_l - isunordered (see chapter "Implementation Notes") + isunordered (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + msgget (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + msgrcv (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + msgsnd (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + semget (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + semop (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + shmctl (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + shmdt (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + shmget (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) signgam - sigpause (see chapter "Implementation Notes") + sigpause (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) canonicalize_file_name clearenv clog10 clog10f clog10l crypt_r (available in external "crypt" library) - dladdr (see chapter "Implementation Notes") + dladdr (see <xref linkend="std-notes">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 (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + qsort_r (see <xref linkend="std-notes">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) (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>) + clock_setres (QNX, VxWorks) (see <xref linkend="std-notes">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) (see <xref linkend="std-notes">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>
reply other threads:[~2021-02-16 11:28 UTC|newest] Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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=20210216112831.52E643854830@sourceware.org \ --to=corinna@sourceware.org \ --cc=cygwin-cvs@sourceware.org \ /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: linkBe 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).