From patchwork Thu Apr 12 19:05:33 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlos O'Donell X-Patchwork-Id: 26698 Received: (qmail 108974 invoked by alias); 12 Apr 2018 19:05:39 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 108957 invoked by uid 89); 12 Apr 2018 19:05:39 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-24.7 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2 spammy=Groups, HX-Google-DKIM-Signature:organization, mandatory X-HELO: mail-yb0-f172.google.com X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:cc:from:subject:organization:message-id:date :user-agent:mime-version:content-language; bh=6ov65Hy/wIfW252jfNE1jyA2XN08syllLng1B/zIqj0=; b=G4Auv2EIvtNK6/HMALRrDXIE8JZlPPl/e4rc+O83i9Y3ZF51PHNyR6XW3giL7cmrP5 yMVtiQdBzHdBwDMHXNqDB9rb2Ia6blYijwZp9OJ/IhFmmKniAmT2TdfocS8l7aIUID63 mLxMsVW4EoxtyZ8lUicHsVeDZNRPzdLX4pHyk0/K9+/Zj9mkMKQtopNq5sMzAvh+tVFg Klxq5Q21ml9LJ408J+fJSaBV4tQBJ58MH5dxSjKuunjR40qI+mcUWucyZ1FRmVivj9Zy EpngeOeCeorcveDN6xti7n53XhD7GYHoQS3ZgAA6KvpMmdgN5MV3B1eh3zjmgAGQvo6j lROw== X-Gm-Message-State: ALQs6tDz7xQQoxsEEbKnd69fjAUxBT494iy3pH5hW+E271jCtDh99hxs zcJSI0TqrHsBywCTFrbjxRvnbQ== X-Google-Smtp-Source: AIpwx48KwesLjDbc1yxF4WSlQ77GPiKXJMJjHXycDDd+d6UrxEOyZgQB9+mXR0iQoDGWkDj9mWhe2A== X-Received: by 2002:a25:6c1:: with SMTP id 184-v6mr1334687ybg.272.1523559936198; Thu, 12 Apr 2018 12:05:36 -0700 (PDT) To: "linux-man@vger.kernel.org" , Michael Kerrisk Cc: Florian Weimer , GNU C Library , Zack Weinberg , Rical Jasan From: Carlos O'Donell Subject: [PATCH 1/2] posixoptions.7: Expand XSI Options groups. Message-ID: <2d6c47e9-0f34-c828-916e-a45fbf90f837@redhat.com> Date: Thu, 12 Apr 2018 14:05:33 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX and all of the X/Open System Interfaces (XSI) Options Groups. The XSI options groups include encryption, realtime, advanced realtime, realtime threads, advanced realtime threads, tracing, streams, and leagcy interfaces. Signed-off-by: Carlos O'Donell From eb192289fb958f427904dd2588aa0419e050bd6a Mon Sep 17 00:00:00 2001 From: Carlos O'Donell Date: Thu, 12 Apr 2018 13:33:00 -0500 Subject: [PATCH 1/2] posixoptions.7: Expand XSI Options groups. We define in detail the X/Open System Interfaces i.e. _XOPEN_UNIX and all of the X/Open System Interfaces (XSI) Options Groups. The XSI options groups include encryption, realtime, advanced realtime, realtime threads, advanced realtime threads, tracing, streams, and leagcy interfaces. Signed-off-by: Carlos O'Donell --- man7/posixoptions.7 | 137 +++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 130 insertions(+), 7 deletions(-) diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index 7e912beae..2c3f2fe96 100644 --- a/man7/posixoptions.7 +++ b/man7/posixoptions.7 @@ -779,13 +779,136 @@ The following functions are present: Always present (probably 0). Value to set a changeable special control character to indicate that it is disabled. -.SH XOPEN EXTENSIONS -.BR _XOPEN_CRYPT , -.BR _XOPEN_LEGACY , -.BR _XOPEN_REALTIME , -.BR _XOPEN_REALTIME_THREADS , -.BR _XOPEN_UNIX . -.\" To be described. +.SH X/OPEN SYSTEM INTERFACES EXTENSIONS +.SS XSI - _XOPEN_CRYPT - _SC_XOPEN_CRYPT +The following functions are present: +.PP +.nf +.in +4n +.IR crypt (), +.IR encrypt (), +.IR setkey () +.SS XSI - _XOPEN_REALTIME - _SC_XOPEN_REALTIME +This option implies the +.B _POSIX_ASYNCHRONOUS_IO == 200112L, +.B _POSIX_FSYNC, +.B _POSIX_MAPPED_FILES, +.B _POSIX_MEMLOCK == 200112L, +.B _POSIX_MEMLOCK_RANGE == 200112L, +.B _POSIX_MEMORY_PROTECTION, +.B _POSIX_MESSAGE_PASSING == 200112L, +.B _POSIX_PRIORITIZED_IO, +.B _POSIX_PRIORITY_SCHEDULING == 200112L, +.B _POSIX_REALTIME_SIGNALS == 200112L, +.B _POSIX_SEMAPHORES == 200112L, +.B _POSIX_SHARED_MEMORY_OBJECTS == 200112L, +.B _POSIX_SYNCHRONIZED_IO == 200112L, +and +.B _POSIX_TIMERS == 200112L +options. +.SS ADV - --- - --- +The Advanced Realtime option group implies the +.B _POSIX_ADVISORY_INFO, +.B _POSIX_CLOCK_SELECTION (implies _POSIX_TIMERS), +.B _POSIX_CPUTIME (implies _POSIX_TIMERS), +.B _POSIX_MONOTONIC_CLOCK (implies _POSIX_TIMERS), +.B _POSIX_SPAWN, +.B _POSIX_SPORADIC_SERVER (implies _POSIX_PRIORITY_SCHEDULING), +.B _POSIX_TIMEOUTS, +and +.B _POSIX_TYPED_MEMORY_OBJECTS +options are all defined to 200112L. +.SS XSI - _XOPEN_REALTIME_THREADS - _SC_XOPEN_REALTIME_THREADS +This option implies the +.B _POSIX_THREAD_PRIO_INHERIT, +.B _POSIX_THREAD_PRIO_PROTECT, +and +.B _POSIX_THREAD_PRIORITY_SCHEDULING +options are all defined to 200112L. +.SS ADVANCED REALTIME THREADS - --- - --- +The option implies the +.B _POSIX_BARRIERS (implies _POSIX_THREADS, _POSIX_THREAD_SAFE_FUNCTIONS), +.B _POSIX_SPIN_LOCKS (implies _POSIX_THREADS, _POSIX_THREAD_SAFE_FUNCTIONS), +.B _POSIX_THREAD_CPUTIME (implies _POSIX_TIMERS), +and +.B _POSIX_THREAD_SPORADIC_SERVER (implies _POSIX_THREAD_PRIORITY_SCHEDULING) +options are all defined to 200112L. +.SS TRACING - --- - --- +The option implies the +.B _POSIX_TRACE, +.B _POSIX_TRACE_EVENT_FILTER, +.B _POSIX_TRACE_LOG, +and +.B _POSIX_TRACE_INHERIT +options and defined to 200112L. +.SS STREAMS - _XOPEN_STREAMS - _SC_XOPEN_STREAMS +The following functions are present: +.PP +.nf +.in +4n +.IR fattach () +.IR fdetach () +.IR getmsg () +.IR getpmsg () +.IR ioctl () +.IR iastream () +.IR putmsg () +.IR putpmsg () +.SS XSI - _XOPEN_LEGACY - _SC_XOPEN_LEGACY +Functions included in the legacy option group were previously mandatory, +but are now optional in this version. +The following functions are present: +.PP +.nf +.in +4n +.IR bcmp (), +.IR bcopy (), +.IR bzero (), +.IR ecvt (), +.IR fcvt (), +.IR ftime (), +.IR gcvt (), +.IR getcwd (), +.IR index (), +.IR mktemp (), +.IR rindex (), +.IR utimes (), +.IR wcswcs () +.SS XSI - _XOPEN_UNIX - _SC_XOPEN_UNIX +The following functions are present: +.PP +.nf +.in +4n +.IR mmap (), +.IR munmap (), +and +.IR msync. +.in -4n +.fi +.PP +The option implies the +.B _POSIX_FSYNC, +.B _POSIX_MAPPED_FILES, +.B _POSIX_MEMORY_PROTECTION, +.B _POSIX_THREAD_ATTR_STACKADDR, +.B _POSIX_THREAD_ATTR_STACKSIZE, +.B _POSIX_THREAD_PROCESS_SHARED, +.B _POSIX_THREAD_SAFE_FUNCTIONS, +and +.B _POSIX_THREADS +options. +.PP +The option may imply the +.B Encryption (_XOPEN_CRYPT), +.B Realtime (_XOPEN_REALTIME), +.B Advanced Raltime (ADB), +.B Realtime Threads (_XOPEN_REALTIME_THREADS), +.B Advanced Realtime Threads (ADVANCED REALTIME THREADS), +.B Tracing (TRACING), +.B XSI Streams (STREAMS), +and +.B Legacy (_XOPEN_LEGACY) +options from the XSI option groups. .SH SEE ALSO .BR sysconf (3), .BR standards (7) -- 2.14.3