POSIX Conformance Template for the 1003.1-2016 Base Product Standard Submitted by Andrew Josey, The Open Group. November 30, 2016 POSIX Conformance Document template for 1003.1-2016 Base Product Standard Requirements (derived from XBD 2.1.2) The conformance document shall have the same structure as IEEE Std 1003.1-2008, with the information presented in the appropriate sections and subsections. Sections and subsections that consist solely of subordinate section titles, with no other information, are not required. The conformance document shall not contain information about extended facilities or capabilities outside the scope of IEEE Std 1003.1-2008. The conformance document shall contain a statement that indicates the full name, number, and date of the standard that applies. The conformance document may also list international software standards that are available for use by a Conforming POSIX Application. Applicable characteristics where documentation is required by one of these standards, or by standards of government bodies, may also be included. The conformance document shall describe the limit values found in the header , stating values, the conditions under which those values may change, and the limits of such variations, if any. (XBD 2.1.2 says "in the headers and "; however, there are currently no limits found in .) The conformance document shall describe the behavior of the implementation for all implementation-defined features defined in IEEE Std 1003.1-2008. This requirement shall be met by listing these features and providing either a specific reference to the system documentation or providing full syntax and semantics of these features. When the value or behavior in the implementation is designed to be variable or customized on each instantiation of the system, the implementation provider shall document the nature and permissible ranges of this variation. The conformance document may specify the behavior of the implementation for those features where IEEE Std 1003.1-2008 states that implementations may vary or where features are identified as undefined or unspecified. The conformance document shall not contain documentation other than that specified in the preceding paragraphs except where such documentation is specifically allowed or required by other provisions of IEEE Std 1003.1-2008. The phrases "shall document" or "shall be documented" in IEEE Std 1003.1-2008 mean that documentation of the feature shall appear in the conformance document, as described previously, unless there is an explicit reference in the conformance document to show where the information can be found in the system documentation. The system documentation should also contain the information found in the conformance document. Base Definitions 3. Definitions 3.4 Additional File Access Control Mechanism The PCD shall document whether, and if so, how additional file access control mechanisms are supported. 3.12 Alternate File Access Control Mechanism The PCD shall document whether, and if so, how additional file alternate control mechanisms are supported. 3.19 Appropriate Privileges The PCD shall document how appropriate privileges are supported. 3.97 Clock Tick The PCD shall document the number of clock ticks that occur each second. 3.118 CPU Time (Execution Time) The PCD shall document the the value of the CPU-time clock for a process, including whether it might not equal the sum of all the execution times of all the threads in a process. 3.160 Extended Security Controls The PCD shall document additional security controls, if any, allowed by the file access permission and appropriate privilege mechanisms through which the system supports different security policies to those described in IEEE Std 1003.1-2008. 3.167 File Group Class If the implementation uses additional criteria beyond those specified to assign a process to the file group class of a file then it shall be included in the PCD. 3.270 Parent Process ID The PCD shall document the new parent process ID of a process after the original creator's lifetime has ended. 3.310 Read-Only File System The PCD shall document the characteristics of a read-only file system that restricts file modifications. 3.435 User Database If the implementation uses the initial numerical group ID for other circumstances than defined for the newgrp utility then the PCD shall document how the initial values are operative. The PCD shall document which program is used if the initial user program field is null. The PCD shall document the effect when the initial working directory field is null. 4. General Concepts 4.3 Directory Protection The PCD shall document whether or not, for a directory that is writable and has the mode bit S_ISVTX set, files in the directory that are writable by the process can be removed or renamed. 4.4 Extended Security Controls The PCD shall document any extended security controls supported by the implementation. 4.9 File Times Update The PCD shall document the resolution of file timestamps for each conforming file system type. 4.11 Measurement of Execution Time The PCD shall document the mechanism used to measure execution time and shall also define to whom the CPU time that is consumed by interrupt handlers and system services on behalf of the operating system will be charged. 4.13 Pathname Resolution The PCD shall document whether the implementation limits the number of symbolic links that can be followed during resolution of a pathname and, if so, what the limit is. The PCD shall document the interpretation of the first component after the leading characters when a pathname begins with two successive characters. 4.16 Seconds Since the Epoch The PCD shall document how any changes are made to the value of seconds since the Epoch to align to a desired relationship with the current actual time. 4.20 Treatment of Error Conditions for Mathematical Functions 4.20.1 Domain Error The PCD shall document the return value for a domain error. 4.20.3 Range Error 4.20.3.2 Result Underflows The PCD shall document the return value for a result that underflows. The PCD shall document whether errno is set to [ERANGE] when the integer expression (math_errhandling & MATH_ERRNO) is non-zero. The PCD shall document whether the ``underflow'' floating-point exception is raised when the integer expression (math_errhandling & MATH_ERREXCEPT) is non-zero. 5. File Format Notation The PCD shall document whether the style for representing floating-point infinity values for the f conversion specifier is "[-]inf" or "[-]infinity". The PCD shall document whether the style for representing floating-point infinity values for the F conversion specifier is "[-]INF" or "[-]INFINITY". The PCD shall document whether the style for representing floating-point NaN values for the f conversion specifier is "[-]nan(/n-char-sequence/)" or "[-]nan". If the form is "[-]nan(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. The PCD shall document whether the style for representing floating-point NaN values for the F conversion specifier is "[-]NAN(/n-char-sequence/)" or "[-]NAN". If the form is "[-]NAN(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. 6. Character Set 6.1 Portable Character Set 6.2 Character Encoding The PCD shall document the effects of the use of a single-shift encoding for interfaces within the the System Interfaces volume of IEEE Std 1003.1-2008 that do not specifically mention the effects of state-dependent encoding. The PCD shall document the effects of the use of a locking-shift encoding with any of the standard utilities in the Shell and Utilities volume of IEEE Std 1003.1-2008 or with any of the functions in the System Interfaces volume of IEEE Std 1003.1-2008 that do not specifically mention the effects of state-dependent encoding. 6.3 C Language Wide-Character Codes The PCD shall document the wide-character codes for characters outside the portable character set. 6.4 Character Set Description File The PCD shall document whether or not users or applications can provide additional character set description files. The PCD shall document the manner in which decimal, octal and hexadecimal constants are represented in the character stored in the system. 7. Locale 7.1 General The PCD shall document the type of file used to store a locale definition created by the localedef utility. The PCD shall document the mechanism used to locate a locale when the value of a locale environment variable does not begin with a slash. 7.2 POSIX Locale The PCD shall the document the implementation's default locale to be invoked when no locale environment variables are set, or they are set to the empty string. 7.3 Locale Definition The PCD shall document whether the implementation supports additional locale categories beyond those specified in the standard. The PCD shall document the values of the characters in the portable character set. 7.3.1 LC_CTYPE The PCD shall document the character mapping for encoded values when automatically including missing characters if no charmap file is in effect. 8. Environment Variables 8.2 Internationalization Variables The PCD shall document additional semantics, if any, for the LC_COLLATE environment variable. The PCD shall document additional semantics, if any, for the LC_CTYPE environment variable. The PCD shall document additional semantics, if any, for the LC_MESSAGES environment variable. The PCD shall document additional semantics, if any, for the LC_MONETARY environment variable. The PCD shall document additional semantics, if any, for the LC_NUMERIC environment variable. The PCD shall document additional semantics, if any, for the LC_TIME environment variable. The PCD shall document which default locale shall be used in the case that all of the following are true: 1. the LC_ALL variable is not defined or is null, and 2. the LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, or LC_TIME variable corresponding to the category being set is not defined or is null, and 3. the LANG variable is not defined or is set to the empty string. The PCD shall document additional criteria, if any, for determining valid locale names. 8.3 Other Environment Variables The PCD shall document the path search for the case when the PATH variable is unset or is set to null. The PCD shall document, in the case when the first character of the TZ variable is a colon, how the characters following it are handled. 10. Directory Structure and Devices 10.1 Directory Structure and Files The PCD shall document which special file, if any, is associated with /dev/console. 11. General Terminal Interface The PCD shall document whether the general terminal interface supports network connections or synchronous ports, or both. 11.1.3 The Controlling Terminal The PCD shall document how the controlling terminal for a session is allocated by the session leader. The PCD shall document whether the terminal becomes the controlling terminal of the session leader for the case when a session leader has no controlling terminal, and opens a terminal device file that is not already associated with a session without using the O_NOCTTY option of open(). 11.1.5 Input Processing and Reading Data If the system imposes a limit, {MAX_INPUT}, on the number of bytes that may be stored in the input queue, the PCD shall document the behavior of the system when this limit is exceeded. 11.1.6 Canonical Mode Input Processing If {MAX_CANON} is defined for a terminal device, the PCD shall document the behavior of the system when this limit is exceeded. 11.1.9 Special Characters The PCD shall document whether the START and STOP characters can be changed. The PCD shall document if any single-bytes other than those defined in this section, or any multi-byte sequences, have special meaning in terminal input when the IEXTEN flag is set. 11.2.2 Input Modes The PCD shall document the definition of a break condition for contexts other than asynchronous serial data transmission. The PCD shall document the precise conditions under which STOP and START characters are transmitted. The PCD shall document the behavior of the system when the input queue overflows. The PCD shall document the initial input control values after a call to the function open(). 11.2.3 Output Modes The PCD shall document the initial output control values after a call to the function open(). 11.2.4 Control Modes The PCD shall document the initial hardware control values after a call to the function open(). 11.2.5 Local Modes The PCD shall document how IEXTEN being set interacts with ICANON, ISIG, IXON, or IXOFF. The PCD shall document the initial local control value after a call to the function open(). 11.2.6 Special Control Characters The PCD shall document the initial values of all control characters. 13. Headers The PCD shall document at what time relocations are performed when RTLD_LAZY is used. The PCD shall document additional macros for floating-point exceptions, if any. They shall begin with the prefix FE_ and an uppercase letter. The PCD shall document additional macros for rounding directions, if any. They shall begin with the prefix FE_ and an uppercase letter. The PCD shall document the default state (on or off) for the FENV_ACCESS pragma. The PCD shall document the accuracy of the floating-point operations ('+', '-', '*', '/') and of the library functions in and that return floating-point results. The PCD shall document the rounding mode for floating-point addition, including documenting any additional values for FLT_ROUNDS beyond those specified. The PCD shall document the evaluation format for the values of operations with floating operands and values subject to the usual arithmetic conversions and for floating constants, including documenting any additional values for FLT_EVAL_METHOD beyond those specified. The PCD shall document the values of FLT_RADIX, FLT_MANT_DIG, DBL_MANT_DIG, LDBL_MANT_DIG, DECIMAL_DIG, FLT_DIG, DBL_DIG, LDBL_DIG, FLT_MIN_EXP, DBL_MIN_EXP, LDBL_MIN_EXP, FLT_MIN_10_EXP, DBL_MIN_10_EXP, LDBL_MIN_10_EXP, FLT_MAX_EXP, DBL_MAX_EXP, LDBL_MAX_EXP, FLT_MAX_10_EXP, DBL_MAX_10_EXP, LDBL_MAX_10_EXP, FLT_MAX, DBL_MAX, LDBL_MAX, FLT_EPSILON, DBL_EPSILON, LDBL_EPSILON, FLT_MIN, DBL_MIN, LDBL_MIN The PCD shall describe the limit values found in the header , stating values, the conditions under which those values may change, and the limits of such variations, if any. The PCD shall document the types used for float_t and double_t, if any, for values of FLT_EVAL_METHOD other than 0, 1 or 2. The PCD shall document additional macros for floating-point classifications, if any. They shall begin with the prefix FP_ and an uppercase letter. The PCD shall document the default state (on or off) for the FP_CONTRACT pragma. The PCD shall document the value of NL_SETD. The PCD shall document whether realtime signal behavior is supported for signals outside of the range SIGRTMIN through SIGRTMAX. The PCD shall document additional signals, if any, beyond those specified. The PCD shall document the values for the limits of specified-width integer types. The PCD shall document the values of the following macros: PTRDIFF_MIN, PTRDIFF_MAX, SIG_ATOMIC_MIN, SIG_ATOMIC_MAX, SIZE_MAX, WCHAR_MIN, WCHAR_MAX, WINT_MIN, WINT_MAX If the MON option is supported, the PCD shall document the maximum possible clock jump for CLOCK_MONOTONIC. System Interfaces 2.3 Error Numbers 2.3.1 Additional Error Numbers The PCD shall document additional error numbers over those specified in IEEE Std 1003.1-2008 Section 2.3, if any, that are defined when the header is #included. 2.4 Signal Concepts 2.4.1 Signal Generation and Delivery The PCD shall document whether a signal is delivered or accepted more than once, for the case when a subsequent occurrence of a pending signal is generated in circumstances other than those in which queuing is required. The PCD shall document any conditions beyond those specified in the System Interfaces Volume of IEEE Std 1003.1-2008 under which the implementation generates signals. 2.4.2 Realtime Signal Generation and Delivery The PCD shall document the signal mask of the thread created to handle a SIGEV_THREAD notification. 2.4.3 Signal Actions The PCD shall document the additional si_code values beyond those specified in XBD , if any, that are set when a signal was not generated by one of the functions or events associated with SI_USER, SI_QUEUE, SI_TIMER, SI_ASYNCIO, or SI_MESGQ. 2.5 Standard I/O Streams The PCD shall document whether the file position indicator is initially positioned at the beginning or end of the file when a file is opened with append mode. The PCD shall document whether the system supports the characteristics for unbuffered, fully buffered and line buffered streams, and the affects, if any of setbuf() and setvbuf(). 2.5.1. Interaction of File Descriptors and Standard I/O Streams The PCD shall document whether and under what conditions all input is seen exactly once. 2.5.2 Stream Orientation and Encoding Rules The PCD shall document the nature and choice of encoding for characters. 2.8 Realtime 2.8.2 Asynchronous I/O The PCD shall document the circumstances under which write operations do not append to the file in the same order as the calls to initiate the operations were made. The PCD shall document the relative priority of asynchronous I/O and synchronous I/O. If _POSIX_PRIORITIZED_IO is defined, the PCD shall document for which files I/O prioritization is supported. 2.8.3 Memory Management If the ML or MLR option is supported, the PCD shall document whether locking memory guarantees fixed translation between virtual addresses (as seen by the process) and physical addresses. If the TYM option is supported, the PCD shall document the manner in which a name is defined at system configuration time to identify each valid combination of a storage pool and a port. 2.8.4 Process Scheduling If the Process Scheduling option is supported, the PCD shall document any additional scheduling policies that are defined beyond the four specified. If the Process Sporadic Server or Thread Sporadic Server option is supported, the PCD shall document the resolution of the execution time clock used for the SCHED_SPORADIC scheduling policy. If the Process Scheduling option is supported, the PCD shall document the effects of sched_ss_low_priority, sched_ss_repl_period, and sched_ss_init for SCHED_OTHER and any additional scheduling policies beyond the four specified. If the Process Scheduling option is supported, the PCD shall document the effect of scheduling threads with the SCHED_OTHER policy in a system in which other threads are executing under SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC (if supported). 2.8.5 Clocks and Timers If the MON option is supported, the PCD shall document the maximum possible clock jump for CLOCK_MONOTONIC. 2.9 Threads 2.9.4 Thread Scheduling If the Thread Execution Scheduling option is supported, the PCD shall document the default scheduling contention scope value and the default values of other scheduling attributes. If the Thread Execution Scheduling option is supported, the PCD shall document the mapping into system attribute space of the scheduling attributes with which a thread with PTHREAD_SCOPE_PROCESS scheduling contention scope was created. If the Thread Execution Scheduling option is supported, the PCD shall document the choice of scheduling allocation domain size and the level of application control over scheduling allocation domains. If the Thread Execution Scheduling option is supported, the PCD shall document the manner in which the scheduling rules defined for SCHED_FIFO, SCHED_RR, and SCHED_SPORADIC (if supported) are used for application threads with scheduling allocation domains of size greater than one. If the Thread Execution Scheduling option is supported, the PCD shall document the manner in which each thread with system scheduling contention scope competes for the processors in its scheduling allocation domain according to its priority. If the Thread Sporadic Server option is supported, the PCD shall document the manner in which the scheduling rules defined for SCHED_SPORADIC are used for application threads whose scheduling allocation domain size is greater than one. If the Thread Execution Scheduling option is supported, the PCD shall document any scheduling policies beyond SCHED_OTHER, SCHED_FIFO, SCHED_RR, and SCHED_SPORADIC, as well as the effects of the scheduling policies indicated by these other values, and the attributes required in order to support such a policy. Furthermore, the PCD shall document the effect of all processor scheduling allocation domain values supported for these policies. 2.10 Sockets 2.10.6 Socket Types The PCD shall document the maximum size of a datagram for all supported protocols. If the RS option is supported, the PCD shall document the format of datagrams sent and received with the SOCK_RAW socket type. 2.10.9 Socket Queue Limits The PCD shall document the default sizes of the transmit and receive queues for a socket for all supported protocols. 2.10.16 Use of Options The PCD shall document the semantics of the debug reports for the SO_DEBUG option. The PCD shall document whether the SO_DONTROUTE option is supported for each protocol. The PCD shall document the default value for the SO_RVCBUF option value. The PCD shall document whether the SO_RCVLOWAT option can be set. The PCD shall document whether the SO_RCVTIMEO option can be set. The PCD shall document the default value for SO_SNDBUF. The PCD shall document the default value for SO_SNDLOWAT, and whether the SO_SNDLOWAT option can be set. The PCD shall document whether the SO_SNDTIMEO option can be set. 2.10.20 Use of Sockets over Internet Protocols Based on IPv6 2.10.20.3 Interface Identification If the IPV6 option is supported, the PCD shall document how unique interfaces are named. Chapter 3 _Exit,_exit The PCD shall document whether open streams are closed (without flushing). The PCD shall document the process ID of the system process that becomes the parent process ID of all the calling process' existing child processes and zombie processes. The PCD shall document whether any outstanding asynchronous I/O operations are canceled, and which I/O may be canceled. acos,acosf,acosl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case of finite values of x not in the range [-1,1]. acosh,acoshf,acoshl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case of finite values of x < 1. aio_cancel The PCD shall document which asynchronous I/O operations are cancelable. asin,asinf,asinl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case of finite values of x not in the range [-1,1]. If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. asinh,asinhf,asinhl If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. atan,atanf,atanl If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. atan2,atan2f,atan2l If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case where the correct value would cause underflow. atanh,atanhf,atanhl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case of finite values of |x| > 1. If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. basename The PCD shall document whether basename returns '/' or "//" when the string pointed to by path is "//" calloc The PCD shall document the behavior of calloc() when the size of space requested is zero; if it returns a null pointer, the PCD shall document whether errno is set and if so what value it is set to. catgets The PCD shall document the security criteria which, when not satisfied, result in an [EBADMSG] error. catopen The PCD shall document the default path used when NLSPATH does not exist in the environment, or a message catalog cannot be found in any of the components specified by NLSPATH. chmod The PCD shall document any additional restrictions that may cause the S_ISUID and S_ISGID bits in mode to be ignored. chown The PCD shall document whether the set-user-ID and set-group-ID bits are altered, in the case when the specified file is a regular file, one or more of the S_IXUSR, S_IXGRP, or S_IXOTH bits of the file mode are set, and the process has appropriate privileges. clock The PCD shall document the value of the era used for determining the return value of the clock() function. clock_getcpuclockid If the CPT option is supported, the PCD shall document the conditions under which one process has permission to obtain the CPU-time clock ID of other processes. clock_getres,clock_settime The PCD shall document the clock resolution for all supported clock IDs. The PCD shall document the effect of setting a clock via clock_settime() on armed per-process timers associated with a clock other than CLOCK_REALTIME. The PCD shall document the appropriate privileges needed to set a particular clock. close The PCD shall document whether any outstanding asynchronous I/O operations are canceled, and which I/O may be canceled. dlerror The PCD shall document whether or not the dlerror() function is thread-safe. dlopen The PCD shall document the class of executable object files eligible to be opened with dlopen() and the manner of their construction. The PCD shall document the manner in which a file argument that does not contain any characters is used to yield a pathname. The PCD shall document at what time relocations are performed (ranging from the time of the dlopen() call until the first reference to a given symbol occurs) when RTLD_LAZY is used. The PCD shall document the precise manner in which an implementation constructs the set of exported symbols for an executable object file. erf,erff,erfl The PCD shall document the return value for the case where the correct value would cause underflow. erfc,erfcf,erfcl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. exec for execlp and execvp The PCD shall document the results of the path search when the environment variable PATH is not present and the argument file does not contain a slash character. The PCD shall document whether null terminators, pointers, and/or any alignment bytes are included in the {ARG_MAX} limit. The PCD shall document the scheduling policy and parameters of the new process image and the initial thread in that new process image when the calling process image does not use the SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC scheduling policies. The PCD shall document whether any outstanding asynchronous I/O operations are canceled, and which I/O may be canceled, upon exec. The PCD shall document the inheritance of process or thread attributes not defined by the System Interfaces volume of IEEE Std 1003.1-2008. exp,expf,expl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. exp2,exp2f,exp2l If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. expm1,expm1f,expm1l If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. fclose The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fcntl The PCD shall document additional values for the cmd argument defined in . Their names shall start with F_. fdim,fdimf,fdiml If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. fegetexecptflag The PCD shall document the stored representation of the states of the floating-point status flags. feraiseexcept The PCD shall document whether the feraiseexcept() function additionally raises the inexact floating-point exception whenever it raises the overflow or underflow floating-point exception. fflush The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fgetc The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fgetwc The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fmemopen The PCD shall document the results produced by the use of the character 'b' in mode strings. fmod,fmodf,fmodl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. fork If the Process Scheduling option is supported, the PCD shall document the policy and priority settings of the child process when the scheduling policy of the parent process is not SCHED_FIFO or SCHED_RR. fpclassify The PCD shall document additional classification categories, if any, beyond NaN, infinite, normal, subnormal and zero. fprintf The PCD shall document the low-order digit rounding for floating-point arguments. The PCD shall document whether the style for representing floating-point infinity values for the f conversion specifier is "[-]inf" or "[-]infinity". The PCD shall document whether the style for representing floating-point infinity values for the F conversion specifier is "[-]INF" or "[-]INFINITY". The PCD shall document whether the style for representing floating-point NaN values for the f conversion specifier is "[-]nan(/n-char-sequence/)" or "[-]nan". If the form is "[-]nan(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. The PCD shall document whether the style for representing floating-point NaN values for the F conversion specifier is "[-]NAN(/n-char-sequence/)" or "[-]NAN". If the form is "[-]NAN(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. The PCD shall document the manner in which the value of a pointer is converted to a sequence of printable characters for the p conversion specifier. fputc The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fputwc The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. freeaddrinfo,getaddrinfo The PCD shall document the behavior of getaddrinfo() when the ai_addrlen, ai_addr, ai_canonname, or ai_next member, or any non-standard additional members, if any, of the hints structure has a value other than the value that would result from default initialization. freopen The PCD shall document the permitted changes of mode, if any, and under what circumstances. fscanf The PCD shall document the behavior when a '-' is in the scanlist and is not the first character, nor the second where the first character is a '^', nor the last character. The PCD shall document the set of sequences that are matched by the p conversion specifier. This shall correspond to the same set of sequences produced by the %p conversion specification of the corresponding fprintf() functions. The PCD shall document the interpretation of the input item for the p conversion specifier. fseek The PCD shall document the behavior of fseek() on devices which are incapable of seeking. The PCD shall document, for locales with state-dependent encoding, whether fseek() restores the stream's shift state. The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fsetpos The PCD shall document the behavior of fsetpos() on devices which are incapable of seeking. The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. fstat If the implementation provides additional or alternative file access control mechanisms, the PCD shall document any conditions that cause fstat() to fail beyond those specified in IEEE Std 1003.1-2008. fstatat,lstat,stat If the implementation provides additional or alternative file access control mechanisms, the PCD shall document any conditions that cause stat(), lstat() and fstatat() to fail beyond those specified in IEEE Std 1003.1-2008. fsync The PCD shall document the manner in which data is transferred to the storage device when an fsync() call occurs. fwprintf The PCD shall document the low-order digit rounding for floating-point arguments. The PCD shall document whether the style for representing floating-point infinity values for the f conversion specifier is "[-]inf" or "[-]infinity". The PCD shall document whether the style for representing floating-point infinity values for the F conversion specifier is "[-]INF" or "[-]INFINITY". The PCD shall document whether the style for representing floating-point NaN values for the f conversion specifier is "[-]nan(/n-char-sequence/)" or "[-]nan". If the form is "[-]nan(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. The PCD shall document whether the style for representing floating-point NaN values for the F conversion specifier is "[-]NAN(/n-char-sequence/)" or "[-]NAN". If the form is "[-]NAN(/n-char-sequence/)" the PCD shall document the meaning of /n-char-sequence/. The PCD shall document the manner in which the value of a pointer is converted to a sequence of printable wide characters for the p conversion specifier. fwscanf The PCD shall document the behavior when a '-' is in the scanlist and is not the first wide character, nor the second where the first wide character is a '^', nor the last wide character. The PCD shall document the set of sequences that are matched by the p conversion specifier. This shall correspond to the same set of sequences produced by the %p conversion specification of the corresponding fwprintf() functions. The PCD shall document the interpretation of the input item for the p conversion specifier. gai_strerror The PCD shall document the set of error strings returned by gai_strerror() on successful completion. getgroups The PCD shall document whether getgroups() also returns the effective group ID in the grouplist array. glob The PCD shall document the contents of pglob->gl_pathv, when the pattern does not match any pathnames. iconv The PCD shall document the conversion performed on characters in the input buffer that are valid, but for which an identical character does not exist in the target codeset. iconv_open The PCD shall document the settings of fromcode and tocode and their permitted combinations. kill If the implementation provides extended security controls, the PCD shall document any further restrictions on the sending of signals, including the null signal. ldexp,ldexpf,ldexpl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. link The PCD shall document whether, when path1 names a symbolic link, link() follows the symbolic link, or creates a new link to the symbolic link itself. listen If the implementation allows a socket to accept connections when listen() has been called with a backlog argument of 0, the PCD shall document the minimum length of the listen queue. log,logf,logl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case when x has a finite value less than zero. log10,log10f,log10l If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case when x has a finite value less than zero. log1p,log1pf,log1pl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case when x has a finite value less than -1. If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. log2,log2f,log2l If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case when x has a finite value less than zero. lseek The PCD shall document the behavior of lseek() on devices which are incapable of seeking. malloc The PCD shall document the behavior of malloc() when the size of space requested is zero; if it returns a null pointer, the PCD shall document whether errno is set and if so what value it is set to. mkdir The PCD shall document the meaning of additional bits other than the file permission bits being set in the mode argument to mkdir(). If the implementation provides a way to initialize the directory's group ID to the effective group ID of the calling process, the PCD shall document it. mkfifo The PCD shall document the effect of additional bits other than the file permission bits being set in the mode argument to mkfifo(). If the implementation provides a way to initialize the FIFO's group ID to the effective group ID of the calling process, the PCD shall document it. mlock If the MLR option is supported, the PCD shall document the limit, if any, on the amount of memory that a process can lock. mlockall If the ML option is supported, the PCD shall document the behavior when MCL_FUTURE is specified and the automatic locking of future mappings eventually causes the amount of locked memory to exceed the amount of available physical memory or any other implementation-defined limit; it shall also document the manner in which the implementation informs the application of these situations. If the ML option is supported, the PCD shall document the limit, if any, on the amount of memory that a process can lock. mmap The PCD shall document the manner in which it calculates the address (pa) at which the mapping will be placed, as a function of the parameter addr and the values of flags. If the XSI option is not supported, the PCD shall document whether MAP_FIXED is supported. The PCD shall document any per process or per system limits on the number of memory regions that can be mapped. mq_open If the MSG option is supported, the PCD shall document the interpretation of characters other than the leading character in the name argument, and the length limits for the name argument. If the MSG option is supported, the PCD shall document the effect of a name argument that does not begin with the character. If the MSG option is supported, the PCD shall document the default message queue attributes for the created message queue when the attr argument required for O_CREAT is NULL. mq_receive If the MSG option is supported, the PCD shall document the result when the value of msg_len is greater than {SSIZE_MAX}. mq_setattr If the MSG option is supported, the PCD shall document any flags other than O_NONBLOCK that can be OR'ed into the mq_flags member of the mq_attr structure. newlocale The PCD shall document the mask values other than LC_CTYPE_MASK, LC_NUMERIC_MASK, LC_TIME_MASK, LC_COLLATE_MASK, LC_MONETARY_MASK, and LC_MESSAGES_MASK that can be OR'ed into the category_mask argument. The PCD shall document the default native environment when the locale string is set to "". open If the implementation provides a way to initialize the file's group ID to the effective group ID of the calling process, the PCD shall document it. The PCD shall document the effect of the O_TRUNC flag for file types other than regular file, FIFO special file or terminal device file. posix_fallocate If the ADV option is supported, the PCD shall document whether a previous posix_fadvise() call influences allocation strategy. posix_mem_offset If the TYM option is supported, the PCD shall document the behavior of this function when the memory object specified by fildes is not a typed memory object. posix_memalign If the ADV option is supported, the PCD shall document the behavior of posix_memalign() when the size of space requested is zero; if it returns an error, the PCD shall document which error number is returned. posix_spawn,posix_spawnp If the SPN option is supported, the PCD shall document the results of the path search when the environment variable PATH is not present and the posix_spawnp() file parameter does not contain a slash character. If the SPN option is supported, the PCD shall document whether the fork handlers are run when posix_spawn() or posix_spawnp() is called. posix_spawnattr_init If the SPN option is supported, the PCD shall document the individual attributes the implementation uses, and their default values unless these values are defined by POSIX.1-2008. Attributes not defined by POSIX.1-2008, their default values, and the names of the associated functions to get and set those attribute values shall be documented. posix_typed_mem_get_info If the TYM option is supported, the PCD shall document any additional information returned in fields of the posix_typed_mem_info structure other than posix_tmi_length. posix_typed_mem_open If the TYM option is supported, the PCD shall document the interpretation of characters other than the leading character in the name argument, and the length limits for the name argument. If the TYM option is supported, the PCD shall document the effect of a name argument that does not begin with the character. If the TYM option is supported, the PCD shall document the manner in which the binding between names and typed memory objects is established. If the TYM option is supported, the PCD shall document the appropriate privileges needed to specify the POSIX_TYPED_MEM_MAP_ALLOCATABLE flag. pow,powf,powl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for finite values of x less than 0 and finite non-integer values of y. If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. pselect, select The PCD shall document the maximum value of the timeout value which shall be at least 31 days. For file types other than sockets, the PCD shall document what constitutes an exceptional condition. For sockets, for cases other than when a receive operation with O_NONBLOCK clear and with the MSG_OOB flag set would return out-of-band data without blocking or when an out of band data mark is present in the receive queue, the PCD shall document the circumstances under which a socket may be considered to have an exceptional condition pending. The PCD shall document whether the function restarts or returns with [EINTR] when the function is interrupted while blocked waiting for any of the selected descriptors to become ready and before the timeout interval expires, and SA_RESTART has been set for the interrupting signal. psignal The PCD shall document the behavior when signum is not a valid signal number. pthread_attr_destroy The PCD shall document whether pthread_attr_destroy() sets attr to an invalid value and if so, what that value is. pthread_attr_getguardsize, pthread_attr_setguardsize The PCD shall document the default value of the guardsize attribute. pthread_attr_setstack If the TSA and TSS options are supported, the PCD shall document any alignment requirements that, if not met, cause pthread_attr_setstack() to fail with [EINVAL]. If the TSA and TSS options are supported, the PCD shall document the upper limit on the value of stacksize, if any. pthread_barrierattr_setpshared The PCD shall document any additional attributes, their default values, and the names of the associated functions to get and set those attribute values. pthread_condattr_init The PCD shall document any additional attributes, their default values, and the names of the associated functions to get and set those attribute values. pthread_getschedparam, pthread_setschedparam If the TPS option is supported, the PCD shall document the scheduling parameters for the SCHED_OTHER policy. If the TPS and TSP options are supported, the PCD shall document whether calling pthread_setschedparam() with a policy of SCHED_SPORADIC is supported when the calling thread's scheduling policy is not SCHED_SPORADIC (in other words, whether the implementation allows the application to dynamically change the scheduling policy to SCHED_SPORADIC). pthread_rwlock_rdlock, pthread_rwlock_tryrdlock If the Thread Execution Scheduling option is not supported, the PCD shall document whether the calling thread acquires the lock when a writer does not hold the lock and there are writers blocked on the lock. The PCD shall document the maximum number of simultaneous read locks that the implementation guarantees can be applied to a read-write lock. pthread_rwlock_unlock If the Thread Execution Scheduling option is not supported, the PCD shall document whether write locks take precedence over read locks when there are threads blocked on a lock when it becomes available. pthread_rwlockattr_getpshared, pthread_rwlockattr_setpshared The PCD shall document any additional attributes, their default values, and the names of the associated functions to get and set those attribute values. read For special device files, the PCD shall document the result of subsequent read() requests after the end-of-file condition has been reached. The PCD shall document the result of a read() call when the value of nbyte is greater than {SSIZE_MAX}. The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. readlink The PCD shall document the result of a readlink() call when the value of bufsize is greater than {SSIZE_MAX}. realloc The PCD shall document the behavior of realloc() when the size of space requested is zero; if it returns a null pointer, the PCD shall document what value errno is set to in the case that the ptr argument is not a null pointer. remainder,remainderf,remainderl If the IEC 60559 Floating-Point option is not supported, the PCD shall document whether a domain error occurs or zero is returned in the case where y is zero. remquo,remquof,remquol The PCD shall document the value n used to determine the magnitude of the result. The value n shall be an integer greater than or equal to 3. If the IEC 60559 Floating-Point option is not supported, the PCD shall document whether a domain error occurs or zero is returned in the case where y is zero. rint,rintf,rintl The PCD shall document how the current rounding mode is determined. scalbln,scalblnf,scalblnl,scalbn,scalbnf,scalbnl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. sched_setparam If the Process Scheduling option is supported, the PCD shall document the conditions under which one process has permission to change the scheduling parameters of another process. If the Process Scheduling option is supported, the PCD shall document the result of calling sched_setparam() when the current scheduling policy for the target process is not SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC. sched_setscheduler If the Process Scheduling option is supported, the PCD shall document the conditions under which one process has permission to change the scheduling parameters of another process. If the Process Scheduling option is supported, the PCD shall document any restrictions as to the appropriate privileges required to set the scheduling policy of the process, or the scheduling policy of another process, to a particular value. If the Process Scheduling option is supported, the PCD shall document the result of calling sched_setscheduler() when the current scheduling policy for the target process is not SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC. sem_open If the SEM option is supported, the PCD shall document the interpretation of characters other than the leading character in the name argument, and the length limits for the name argument. If the SEM option is supported, the PCD shall document the effect of a name argument that does not begin with the character. setlocale The PCD shall document the valid strings for the locale argument. The PCD shall document the default native environment when the locale string is set to "". shm_open If the SHM option is supported, the PCD shall document the interpretation of characters other than the leading character in the name argument, and the length limits for the name argument. If the SHM option is supported, the PCD shall document the effect of a name argument that does not begin with the character. sigaction The PCD shall document the disposition of subsequent occurrences of sig when it is already pending, when SA_SIGINFO is not set in sa_flags. signal The PCD shall document whether when a signal occurs and func points to a function, the equivalent of signal(sig,SIG_DFL) is executed or if the the implementation prevents some set of signals (at least including sig) from occurring until the current signal handling has completed. If the latter then the PCD shall document the set of signals. The PCD shall document values other than SIGFPE, SIGILL or SIGSEGV that correspond to a computational exception. sigwait The PCD shall document in the case when prior to a call to sigwait() there are multiple pending instances of a single signal number, whether upon successful return there are any remaining pending signals for that signal number. sin,sinf,sinl If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. sinh,sinhf,sinhl If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. socket The PCD shall document the address families supported by the system. The PCD shall document the protocols supported by the system. socketpair The PCD shall document the protocols supported by the system. sqrt,sqrtf,sqrtl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case of finite values of x < -0. strfmon The PCD shall document the result when the value of maxsize is greater than {SSIZE_MAX}. strsignal The PCD shall document the mapping of signal numbers to strings for the strsignal() function. It shall use the same set of messages as the psignal() function. strtod,strtof,strtol The PCD shall document the meaning of the n-char sequences. symlink If the implementation provides a way to initialize the symbolic link's group ID to the effective group ID of the calling process, the PCD shall document it. system The PCD shall document the manner in which the system() function passes the string pointed to by command to the command processor to be executed in the case when command is not a null pointer. tan,tanf,tanl If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. tanh,tanhf,tanhl If the IEC 60559 Floating-Point option is supported, the PCD shall document the return value for the case of subnormal x. tcsendbreak The PCD shall document the period of time that tcsendbreak() sends zero-valued bits for when the duration argument is not zero. The PCD shall document when the terminal is not using asynchronous serial data transmission, whether tcsendbreak() sends data to generate a break condition or returns without taking any action. tgamma,tgammaf,tgammal If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case when x is a negative integer. If the IEC 60559 Floating-Point option is not supported, the PCD shall document the return value for the case where the correct value would cause underflow. timer_create If the CPT or TCT option is supported, the PCD shall document whether a timer_create() call will succeed when the value defined by clock_id corresponds to the CPU-time clock of a process or thread different from the process or thread invoking the function. timer_getoverrun The PCD shall document the value of {DELAYTIMER_MAX}. tmpnam The PCD shall document the behavior if the function is called more than {TMP_MAX} times in a single process. tzset The PCD shall document the default timezone information used by the system if the TZ environment variable is not set. umask The PCD shall document the meaning of additional bits other than the file permission bits being set in the cmask argument to umask(). uname The PCD shall document the communications network for this node. The PCD shall document the format of each member of the utsname structure. wait, waitpid The PCD shall document additional circumstances under which wait() or waitpid() report status, if any. If there are additional circumstances the PCD shall document the interpretation of the reported status. The PCD shall document the system process that is assigned as the new parent process ID of the child processes of a parent process that terminates without waiting for those child processes to terminate. wcstod,wcstof,wcstol The PCD shall document the meaning of the n-wchar sequences. The PCD shall document the rounding of the conversion when the subject sequence has the hexadecimal form and FLT_RADIX is a power of 2. write The PCD shall document the result of a write() call when the value of nbyte is greater than {SSIZE_MAX}. The PCD shall document the maximum file size. The PCD shall document any additional circumstances to those specified for an [EIO] error to be returned. Shell and Utilities 1.1 Relationship to Other Documents 1.1.1 System Interfaces 1.1.1.4 File Read, Write, and Creation The PCD shall document for all the items in table 1-1 marked with a dash (-) the effects of the actions when creating a file that already exists unless the action is specified in a utility description. 1.1.1.5 File removal The PCD shall document the effect of removing a directory that is the root directory or current working directory of any process. 2. Shell Command Language 2.5 Parameters and Variables 2.5.3 Shell Variables The PCD shall document the default value of PS1 for users with additional privilege, if different from "$ ". If different, in addition the PCD shall document the privileges of such users. 2.7 Redirection The PCD shall document the largest possible value for the decimal numbers used to represent open files (file descriptors). [Note The numbers start with zero and are decimal. At least the values 0 to 9 inclusive are available to all applications.] Chapter 4 Utilities at The PCD shall document the execution-time attributes, other than environment variables, current working directory, and file creation mask, that are retained and used when the at-job is executed. The PCD shall document the meanings of values for the queuename option-argument other than 'a' and 'b'. The PCD shall document the acceptable timezone names, other than utc, within the timespec operand. They shall be case-insensitive. awk The PCD shall document whether any modification of ENVIRON affects the environment that was used at the time awk began executing. The PCD shall document the default value of the SUBSEP special variable. The PCD shall document the limit on the number of open expression arguments opened by a print or printf statement or a call to getline. basename The PCD shall document whether steps 3 to 6 (of the DESCRIPTION) are skipped or processed when the argument string is "//". c99 If the CD option is supported, the PCD shall document any additional macro names (defined as if by a C-language #define directive) that are provided by the compiler. If the CD option is supported, the PCD shall document any interactions of other options with the -g option that modify the symbolic information produced in the object or executable files. If the CD option is supported, the PCD shall document any suffixes other than ".a" that are recognized as denoting libraries when searching for a library specified by the -l option. If the CD option is supported, the PCD shall document any suffixes other than ".a" that are recognized as denoting libraries when processing pathname operands. If the CD option is supported, the PCD shall document any suffixes other than ".o" that are recognized as denoting object files when processing pathname operands. If the CD option is supported, the PCD shall document the processing of files other than C-language source files, libraries of object files, and object files as pathname operands. If the CD option is supported, the PCD shall document any additional input file formats beyond a text file containing a C-language source program, an object file in the format produced by c99 -c, or a library of object files, in the format produced by archiving zero or more object files, using ar. If the CD option is supported, the PCD shall document the maximum symbol length supported by the compiler and link editor for external symbols. It shall be at least 31. If the CD option is supported, the PCD shall document the maximum number of external symbols supported by the compiler and link editor. It shall be at least 511 per source or object file, and at least 4095 in total. cd The PCD shall document the behavior of cd if no directory operand is given and the HOME environment variable is empty or undefined. chmod The PCD shall document whether and how the chmod utility affects any alternate or additional file access control mechanism. The PCD shall document when using the symbolic mode form on a regular file whether or not : 1. Requests to set the set-user-ID-on-execution or set-group-ID-on-execution bit when all execute bits are currently clear and none are being set are ignored. 2. Requests to clear all execute bits also clear the set-user-ID-on-execution and set-group-ID-on-execution bits. 3. Requests to clear the set-user-ID-on-execution or set-group-ID-on-execution bits when all execute bits are currently clear are ignored. However, if the command ls -l file writes an s in the position indicating that the set-user-ID-on-execution or set-group-ID-on-execution is set, the commands chmod u-s file or chmod g-s file, respectively, shall not be ignored. The PCD shall document when using the symbolic mode form on file types other than regular files, whether or not requests to set or clear the set-user-ID-on-execution or set-group-ID-on-execution bits are honored. The PCD shall document when using the octal integer mode on file types other than regular files whether or not requests to set or clear the set-user-ID-on-execution or set-group-ID-on-execution bits are honored. cksum The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) cp The PCD shall document the behavior of cp when source_file is a file of type directory and the dest_file exists and is a file type not specified by the System Interfaces volume of IEEE Std 1003.1-2008. The PCD shall document the permissions, owner ID, and group ID of dest_file with the -R option, when source_file does not reference the same file as dest_file, AND source_file is not of type directory, AND source_file is not of type regular file AND source_file is not of type FIFO. If the implementation provides additional or alternate access control mechanisms the PCD shall document the effect on copies of files. The PCD shall document for the -p option whether additional bits besides the file permission bits and the S_ISUID and S_ISGID bits are duplicated. crontab The PCD shall document the method via which any generated output or errors are mailed to the user when standard output and standard error are not redirected by commands executed from a crontab entry. ctags If the SD option is supported, the PCD shall document the handling of files with suffixes other than ".c", ".h" and ".f". df The PCD shall document the format used to output the name of the file system, when the -P option is used. The PCD shall document the exact meaning of the figure output for the total size of the file system , when the -P option is used. The figure should include , , plus any space reserved by the system not normally available to a user. diff The PCD shall document the behavior of diff on file types other than block special files, character special files, FIFO special files and regular files, when found in directories. The PCD shall document whether diff uses the binary file output format when the current locale is the POSIX locale and one or both of the files being compared are not text files. The binary file output format shall contain the pathnames of two files being compared and the string "differ". The PCD shall document the behavior when the -u or -U option is used and a pathname contains a or a , or does not consist entirely of characters taken from the portable character set. The PCD shall document the output format for the field when the -u or -U option is used and the timezone is not an integral number of minutes away from UTC. The PCD shall document whether an empty unaffected line is written as an empty line or a line containing a single character when the -u or -U option is used. dirname The PCD shall document whether steps 7 and 8 (of the DESCRIPTION) are skipped or processed when the remaining string is // . du The PCD shall document whether a file that has a link count no greater than 1 is counted and written just once, or is counted and written for each occurrence. The PCD shall document whether a file that occurs under one file operand is counted for other file operands. echo If the XSI option is not supported, the PCD shall document the results when the first operand is -n, or any of the operands contain a character. ex The PCD shall document the set of user IDs which, when a .exrc file in the current directory exists, is owned by one of this set of user IDs, and is not writable by anyone other than the owner, the ex utility attempts to execute the ex commands contained in that file. The PCD shall document whether a character other than -V performs the "literal next" function if that functionality is performed by the underlying system. The PCD shall document whether a character other than -W performs the "word erase" function if that functionality is performed by the underlying system. The PCD shall document any restrictions on the set of characters accepted in lhs or rhs of the abbreviate command. Printable characters and characters shall not be restricted. The PCD shall document the default directory used by the change directory command when no directory argument is specified and the HOME environment variable is empty or undefined. The PCD shall document any restrictions on the set of characters accepted in lhs or rhs of the map command. Printable characters and characters shall not be restricted. The PCD shall document what characters other than a single lowercase letter of the POSIX locale and the backquote and single-quote characters are supported by the mark command. The PCD shall document the multi-character sequences used to represent non-printable characters, except for the , by the print command. The PCD shall document any additional tests that may cause the write command to fail. The PCD shall document the default value for the directory option. The PCD shall document what reasons beyond those specified may cause the readonly edit option to be initialized to set. The PCD shall document what information other than a differentiation between command mode and text input mode, if any, is displayed on the last line of the display when the showmode option is set. The PCD shall document whether, and if so in what manner, the default value for the window option is changed by the baud rate of the terminal line. The PCD shall document the effect of the wrapmargin option when the current locale is not the POSIX locale. expand The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) fc The PCD shall document the upper limit on the numbers used to reference command history. The limit shall be no smaller than the value in HISTSIZE or 32767 (whichever is greater). The PCD shall document whether changes made to HISTFILE after the history file has been initialized are effective. The PCD shall document the specific circumstances under which the history list mechanism is disabled for users with appropriate privileges who do not set HISTFILE. file The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) The PCD shall document any file types identified by the file utility beyond those specified. If the C-Language Development Utilities option is not supported, the PCD shall document the default number of bytes represented by the type specifiers d, f, and u. The PCD shall document the byte order used when interpreting numeric values. It shall correspond to the order in which a constant of the corresponding type is stored in memory on the system. find The PCD shall document whether find replaces the two characters "{}" or uses the string without change, when a utility_name or argument string supplied to an instance of the -exec primary punctuated by a contains the two characters "{}", but not just the two characters "{}". The PCD shall document the results of evaluating the -perm primary when the file type evaluated for the current file is a symbolic link. fold The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) gencat The PCD shall document the default message set NL_SETD in which all messages are located when no $set directive is specified in a message text source file. The PCD shall document the effects of lines starting with any character other than those defined in the gencat EXTENDED DESCRIPTION section in POSIX.1-2008. grep The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) head The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) iconv The PCD shall document valid values of names of the codeset descriptions for the fromcode option-argument to the -f option. lex If the CD option is supported, the PCD shall document the informational, error, and warning messages concerning the contents of lex source code input that are written to either the standard output or standard error when the -t option is not specified. If the CD option is supported, the PCD shall document the format used for the lex statistics written to either the standard output or standard error when the -v option is specified and the -n option is not specified. If the CD option is supported, the PCD shall document the informational, error, and warning messages concerning the contents of lex source code input that are written to the standard error when the -t option is specified. If the CD option is supported, the PCD shall document whether the default type for yytext is an array or a pointer. If the CD option is supported, the PCD shall document the exact meaning of the table size numbers that can be set in the Definitions section. The PCD shall document how these numbers affect the lex utility and how they are related to any output that may be generated by the implementation should limitations be encountered during the execution of lex. ln The PCD shall document the behavior for existing files of a type not specified by the System Interfaces Volume of IEEE Std 1003.1-2008, if any. The PCD shall document which of the -L and -P options will be used as the default when the -s option is not specified and neither a -L nor a -P option is specified. The PCD shall document whether a directory can be linked when the -s option is not specified. locale The PCD shall document the manner in which the implementation determines what locales besides the POSIX locale are available. The PCD shall document whether any keyword values are written for the categories LC_CTYPE and LC_COLLATE, when they are given as the name argument to locale. localedef If the XSI option is not supported, the PCD shall document whether users have the capability to create new locales in addition to those supplied with the implementation. The PCD shall document any implementation categories beyond LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC, LC_TIME and LC_MESSAGES, if any, for the category source definitions. The PCD shall document the character mapping used when the -f option is not present. The PCD shall document the interpretation of the name operand that identifies the locale, when name does not contain any characters. The PCD shall document the name of valid codesets for use with the -u option. The PCD shall document the method by which ISO/IEC 10646-1:2000 standard position constant values are converted when the -u option is used. The PCD shall document the assignment of character encoding values. The PCD shall document other conditions that cause localedef to generate warnings beyond those specified, if any. logger The PCD shall document whether messages written in locales other than the POSIX locale are effective. lp The PCD shall document the conditions under which a banner page can be suppressed, if any. ls The PCD shall document any condition that causes directory entries beginning with a period to be written when neither the -a option nor the -A option is specified. The PCD shall document the block size used when the -k option is not specified. The PCD shall document the number of column positions assumed when COLUMNS is not set or invalid. The PCD shall document the format when output is to a terminal. The PCD shall document the information associated with a device that is output as the field. The PCD shall document additional characters used for the character to describe the type of file, beyond those specified, if any. m4 The PCD shall document the behavior when a stream number larger than 9 is specified as an argument to the divert macro. mailx The PCD shall document how messages that are not text files are stored in files written by mailx. The PCD shall document the default value of the crt internal mailx variable when it is set to null. The PCD shall document the other headers presented for editing beyond those specified, if any, when the command escape ~h is used and the standard input is a terminal. make If the SD option is supported, the PCD shall document what files, if any, are tried when neither ./makefile nor ./Makefile (nor ./s.makefile, SCCS/s.makefile, ./s.Makefile, and SCCS/s.Makefile if the XSI option is supported) is found. If the SD option is supported, the PCD shall document the interpretation of targets containing the characters '%' and '"'. If the SD option is supported, the PCD shall document the manner in which the command line options and command line macro definitions added to the MAKEFLAGS macro are quoted. The quoting shall be such that when MAKEFLAGS is read by another instance of the make command, the original macro's value is recovered. If the SD option is supported, the PCD shall document any other options and macros that are added to the MAKEFLAGS macro. If the SD option is supported, the PCD shall document what other variables beyond those specified, if any, are added to the environment of make before the makefile(s) are read. If the SD option is supported, the PCD shall document any other effects, beyond those specified, of defining SHELL in the makefile or on the command line. man The PCD shall document the manner for providing information beyond that specified, if any, for the standard utilities. The PCD shall document the format of standard output for the man utility. more If the UP option is supported, the PCD shall document the character sequence used to display characters when the -u option is specified. If the UP option is supported, the PCD shall document how other non-printable characters beyond those specified are written. If the UP option is supported, the PCD shall document what commands beyond those specified are included in the command summary written by the h command. If the UP option is supported, the PCD shall document whether line-setting options are passed to editors other than vi and ex. mv The PCD shall document the behavior for existing files of a type not specified by the System Interfaces Volume of IEEE Std 1003.1-2008, if any. newgrp The PCD shall document whether users not listed as members of the specified group can change to that group when no password is required for the group. The PCD shall document any system accounting or security mechanisms that impose additional authorization restrictions that may cause newgrp to write a diagnostic message and suppress the changing of the group identification. nice The PCD shall document the quantity greater than or equal to the nice value of the current process with which the executed utility is run when no options are specified. nm If the SD option is supported, the PCD shall document the additional object library formats, if any, that are accepted for the input file beyond an object file, an object-file library whose format is the same as those produced by the ar utility for link editing, or an executable file. If the SD option is supported, the PCD shall document the symbol types represented by a single character beyond those specified. od The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) The PCD shall document the byte order when interpreting numeric values. It shall correspond to the order in which a constant of the corresponding type is stored in memory on the system. The PCD shall document the result when either the -j skip or -N count option is specified along with the c type specifier, and this results in an attempt to start or finish in the middle of a multi-byte character. patch The PCD shall document whether a rejected hunk that is a unified context difference is written in copied-context-difference format or in unified-context-difference format. pax The PCD shall document the results in copy mode, if the destination directory is a file of a type not specified by the System Interfaces Volume of IEEE Std 1003.1-2008. The PCD shall document the default output archive format. The PCD shall document how the pax utility determines what file to read or write as the next file for an archive that spans multiple files. The PCD shall document which devices on the system support appending for use with the -a option The PCD shall document any other characters beyond those specified for the file characteristics for the -p option. The PCD shall document any other file characteristics beyond those specified for the e and p characters used with the -p option. The PCD shall document any extensions beyond those specified within pax Extended Header. The PCD shall document the format for the additional conversion specifier character, D, used to specify the device for block or special files. The PCD shall document the input file formats accepted by pax beyond those specified. The PCD shall document whether pax includes a charset extended header record when used in write or copy mode. The PCD shall document the results when any of the UTF-8 characters cannot be translated in the header record, and neither the -oinvalid=UTF-8 option nor the -oinvalid=binary option is specified. The PCD shall document the encodings of the characters, if an implementation supports the use of characters outside of and the portable filename character set in names for files, users, and groups. The PCD shall document for each interchange format whether the data from a file is stored on the file hierarchy and under what name it is stored when the filename found on the medium creates an invalid filename. The PCD shall document handling of other file types beyond those specified for the ustar and pax interchange formats. The PCD shall document the format of the c_rdev field for the cpio interchange format. ps If the XSI option is not supported, the PCD shall document the format of terminal identifiers given as the option-argument to the -t option. The PCD shall document whether any further truncation of the output for -o args occurs, other than the optional truncation to the field width. The PCD shall document any additional variable names beyond those specified that are accepted in the option-argument to the -o option. (For each additional variable the system documentation shall specify the default header and indicate whether the field may contain characters.) renice The PCD shall document the manner in which the nice value is bounded. The PCD shall document the limit values that are used when the requested increment would raise or lower the nice value of the executed utility beyond those limits. sed The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) sh The PCD shall document the offset maximum established in the open file description for shell input and output redirections. If the UP option is supported, the PCD shall document the specific circumstances under which the history list mechanism is disabled for users with appropriate privileges who do not set HISTFILE. strings The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) The PCD shall document any additional strings that are written beyond those specified. The PCD shall document what portion of each file is scanned for strings when the -a option is not specified. stty The PCD shall document default options for a terminal. The PCD shall document any special control characters, beyond those specified, that are enabled by iexten. tail The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) talk If the UP option is supported, the PCD shall document the existence and processing of any additional special control characters and multi-byte or single-byte functions that occur when and only when the stty iexten local mode is enabled. If the UP option is supported, the PCD shall document the sequences of printable characters to be sent to the recipient's terminal when non-printable characters beyond those specified are typed. test The PCD shall document any additional operators and primary_operators that are provided. They shall be of the form -operator where the first character of operator is not a digit. touch The PCD shall document the behavior when a time specified using the -d or -t option precedes the Epoch. The PCD shall document the range of valid times past the Epoch. It shall extend to at least the time 0 hours, 0 minutes, 0 seconds, January 1, 2038, Coordinated Universal Time. tput The PCD shall document the manner in which the sequence that is displayed when the "init" operand is specified initializes the user's terminal. The PCD shall document the manner in which the sequence that is displayed when the "reset" operand is specified resets the user's terminal. tsort The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) uname The PCD shall document the format and contents of the symbols written to the standard output. The PCD shall document the communications network used with the -n option. The PCD shall document any additional symbols written beyond those specified, when the -a option is specified. All such symbols shall be written at the end of the line of output before the . unexpand The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) vi If the UP option is supported, the PCD shall document whether other characters beyond those specified are searched for and matched by the % command. If the UP option is supported, the PCD shall document whether the -H command is an error or if the cursor moves back one autoindent character, when there are autoindent characters on the current line before the cursor. If the UP option is supported, the PCD shall document whether the -H command is an error or if it is equivalent to entering -H after the last input character on the previous input line, when the cursor is in column position 1 and there are previous lines that have been input. If the UP option is supported, the PCD shall document whether the -U command is an error or if the cursor moves to the first column position on the line, when there are autoindent characters on the current line before the cursor. If the UP option is supported, the PCD shall document whether the -U command is an error or if it is equivalent to entering -U after the last input character on the previous input line, when the cursor is in column position 1 and there are previous lines that have been input. If the UP option is supported, the PCD shall document whether the -W command is an error or if the cursor moves to the first column position on the line, when there are autoindent characters on the current line before the cursor. If the UP option is supported, the PCD shall document whether the -W command is an error or if it is equivalent to entering -W after the last input character on the previous input line, when the cursor is in column position 1 and there are previous lines that have been input. wc The PCD shall document whether a file operand of '-' stands for standard input or for a file named -. (Derived from XBD 12.2 Utility Syntax Guidelines.) who The PCD shall document the domain of accessibility of the users about whom the who utility lists various pieces of information. The PCD shall document the format in which the who utility writes its default format to the standard output. write The PCD shall document the existence and processing of any additional special control characters and multi-byte or single-byte functions that occur when and only when the stty iexten local mode is enabled. The PCD shall document the sequences of printable characters to be sent to the recipient's terminal when non-printable characters beyond those specified are typed. The PCD shall document the manner in which the recipient's terminal is selected when the recipient is a user who is logged in more than once and no terminal argument is specified. yacc If the CD option is supported, the PCD shall document the manner in which the limits, if any, for internal tables are reported in the description file. If the CD option is supported, the PCD shall document the exact meaning of the minimum maximum values shown in table 4-23. The implementation shall define the relationship between these values and between them and any error messages that the implementation may generate should it run out of space for any internal structure.