Draft POSIX Conformance Template for Austin-231 Page 1 of 1 the 1003.13, 2003 Edition PSE54 Submitted by Andrew Josey, The Open Group. December 10, 2004 IEEE Std 1003.13-2003 states "(1) If the implementation is fully conformant to the referenced base standard(s), then that implementation may cite the separate conformance documents that document the base standard conformance. This will primarily apply to implementations that support the PSE53 or PSE54 Profiles." If you choose not to cite a reference below follows a sample template for 1003.1-2001 that you should complete. Regardless of whether separate base standard conformance documents are cited, the conformance document for these profile(s) shall contain a statement that indicates the full name, number, and date of the standard (i.e., the profile standard) that applies. The text below is a version of the PCD for 1003.1 with various options removed that are not applicable to PSE54 (that is, BE, XSR, most of XSI) POSIX Conformance Document Requirements (derived from XBD 2.1.2) The conformance document shall have the same structure as IEEE Std 1003.1-2001, 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-2001. 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 headers and , stating values, the conditions under which those values may change, and the limits of such variations, if any. The conformance document shall describe the behavior of the implementation for all implementation-defined features defined in IEEE Std 1003.1-2001. 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-2001 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-2001. The phrases "shall document" or "shall be documented" in IEEE Std 1003.1-2001 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.117 CPU Time (Execution Time) If the THR option is supported, the PCD shall document an explanation of how the value of the CPU-time clock for a process is determined. 3.159 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-2001. 3.166 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.187 Group Database The PCD shall document the format of the group database. 3.265 Parent Process ID The PCD shall document the new parent process ID of a process after the original creator's lifetime has ended. 3.304 Read-Only File System The PCD shall document the characteristics of a read-only file system that restricts file modifications. 3.383 System Databases The PCD shall document the effects of the User Database when the initial working directory field is null. 3.387 System Trace Event If the TRC option is supported: The PCD shall document the name of system trace events beyond those specified in IEEE Std 1003.1-2001. The PCD shall document the content and length of data for system trace events beyond those specified in IEEE Std 1003.1-2001. 3.409 Trace Generation Version If the TRC option is supported, the PCD shall describe the characteristics of the Trace Generation Version data object generated by the trace system that describes the origin and version of the trace system. 3.424 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 Extended Security Controls The PCD shall document any extended security controls supported by the implementation. 4.9 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.11 Pathname Resolution The PCD shall document the interpretation of a pathname that begins with two successive slashes . 4.14 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.17 Tracing If the TRC option is supported, the PCD shall document the actions associated with a trace point, if any. 4.18 Treatment of Error Conditions for Mathematical Functions 4.18.1 Domain Error The PCD shall document the return value for a domain error. 4.18.3 Range Error 4.18.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 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-2001 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-2001 or with any of the functions in the System Interfaces volume of IEEE Std 1003.1-2001 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 hexidecimal 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. If _POSIX2_LOCALEDEF is supported, the PCD shall document additional keywords supported by the implementation, if any. 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, and 2. the LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, and LC_TIME variables are not defined, 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 locales. 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 following characters are handled. a first character 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 implementation 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 (see 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. 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 any extended functions enabled by the IEXTEN mask. 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 (If the XSI option is supported [this feature requ'd for PSE54]) The PCD shall document the circumstances under which relocations are performed for RTLD_LAZY. 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 beyond those specified. The PCD shall document the evaluation format mode for operations with floating operands and values including documenting any additional values 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 headers , stating values, the conditions under which those values may change, and the limits of such variations, if any. The PCD shall document the values 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. If the IP6 option is supported The PCD shall document additional fields, if any, in the sockaddr_in6 structure beyond those specified. If IP6 option is supported The PCD shall document the mapping of sin6_scope_id to an interface or set of interfaces. The PCD shall document whether realtime signal behavior is supported for other 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 The PCD shall document other file mode bits, if any, that can be OR'd into S_IRWXU, S_IRWXG, and S_IRWXO. If the MON option is supported the PCD shall document the maximum possible clock jump for the system-wide monotonic clock. System Interfaces 2.3 Error Numbers (1114) The PCD shall document additional error numbers over those specified in IEEE Std 1003.1-2001 Section 2.3, if any, that are defined when the header is #included. 2.4 Signal Concepts (1155) 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. (1166) The PCD shall document any conditions beyond those specified in the System Interfaces Volume of IEEE Std 1003.1-2001 in which the implementation generates signals. 2.4.2 Realtime Signal Generation and Delivery (1231) If the RTS option is supported the PCD shall document the signal mask for threads created that use the alternate event notification (sigev_notify_function). 2.4.3 Signal Actions (1314) If the RTS option is supported if a signal is generated by functions or events other than those specified in this section, the PCD shall document si_code value set for the corresponding event or function. 2.5 Standard I/O Streams (1392) 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. (1404) The PCD shall document whether the system supports the characteristics for unbuffered and fully buffered streams, and the affects, if any of setbuf() and setvbuf(). 2.5.1. Interaction of File Descriptors and Standard I/O Streams (1489) The PCD shall document whether and under what conditions all input is seen exactly once. 2.5.2 Stream Orientation and Encoding Rules (1530) The PCD shall document the nature and choice of encoding for characters. 2.8 Realtime 2.8.2 Asynchronous I/O If the AIO option is supported (1709) The PCD shall document any circumstances under which the ordering restrictions on operations are relaxed. (1736) The PCD shall document the relative priority of asynchronous I/O and synchronous I/O . 2.8.3 Memory Management (1765) If the ML or MLR options are supported the PCD shall document whether locking memory guarantees fixed translation between virtual addresses (as seen by the process) and physical addresses. 2.8.3.4 Typed Memory Objects (1814) If the TYM option is supported the PCD shall document the identifier names for each valid combination of a storage pool and a port 2.8.4 Processing Sheduling If the PS option is supported (1851) The PCD shall document any other scheduling policies beyond those specified. (1941) If the SS or TSP options are supported The PCD shall document the resolution of the execution time clock for the scheduling policies supported. (1984) The PCD shall document the effect of scheduling threads with the SCHED_OTHER policy when other threads are executing under SCHED_FIFO, SCHED_RR or (if the SS option is supported) SCHED_SPORADIC. 2.8.5 Clocks and Timers (2034) If the MON option is supported the PCD shall document the The maximum possible clock jump for the system-wide monotonic clock. (2041) If the actual resolution supported for a time service based on one of the supported clocks differs from the resolution supported for that clock, then the PCD shall document this difference. 2.9.4 Thread Scheduling If the TPS option is supported (2161) the PCD shall document the default scheduling contention scope, and the default values of other scheduling attributes. (2176) The PCD shall document how the system scheduling attributes of a thread created with PTHREAD_SCOPE_PROCESS scheduling contention scope map to the system attribute space of the scheduling attributes with which the thread was created. (2200) The PCD shall document how the system determines its choice of scheduling allocation domain size, and describe the level of application control over scheduling allocation domains. (2211) The PCD shall document for application threads with scheduling allocation domains of size greater than one, how the rules defined for SCHED_FIFO, SCHED_RR, and SCHED_SPORADIC are used. (2212) The PCD shall document the manner in how each thread with system scheduling contention scope competes for the processors in its scheduling allocation domain according to its priority. (2216) If the TSP option is supported The PCD shall document how the rules defined for SCHED_SPORADIC in Scheduling Policies (on page 44) are used for application threads whose scheduling allocation domain size is greater than one. (2219) 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 implementation shall document the effect of all processor scheduling allocation domain values supported for these policies. 2.10 Sockets 2.10.6 Socket Types (2446) The PCD shall document the maximum size of a datagram for all supported protocols. (2455) If the RS option is supported The PCD shall document the format of datagrams sent and received with this socket type. 2.10.9 Socket Queue Limits (2473) The PCD shall document the default sizes of the the transmit and receive queue sizes for a socket. 2.10.16 Use of Options (2624) The PCD shall document the semantics of the debug reports for the SO_DEBUG option. (2630) The PCD shall document whether the SO_DONTROUTE option is supported for each protocol. (2651) The PCD shall document the default value for the SO_RVCBUF option value. (2663) The PCD shall document whether the SO_RCVLOWAT option can be set. (2670) The PCD shall document whether the SO_RCVTIMEO option can be set. (2677) The PCD shall document the default value for SO_SNDBUF. (2687) The PCD shall document the default value for SO_SNDLOWAT, and whether the SO_SNDLOWAT option can be set. (2695) The PCD shall document whether the SO_SNDTIMEO option can be set. 2.10.20.3 Interface Identification (2809) The PCD shall document how unique interfaces are named. 2.11 Tracing If the TRC option is supported: 2.11.1 Tracing Definitions (3079) The PCD shall document the characteristics of system trace events. (3100) The PCD shall document the clock used for the posix_timestamp member ( the time at which the trace event was generated ). 2.11.2 Trace Event Type Definitions (3153) The PCD shall document any system specific trace error conditions. (3166) The PCD shall document conditions that can generate a POSIX_TRACE_ERROR trace event. ------ XSH Chapter 3 acos,acosf,acosl The PCD shall document the return value for the case of finite values of x not in the range [-1,1]. If the MX option is supported the PCD shall document the return value for the case when x is +/-Inf. acosh,acoshf,acoshl The PCD shall document the return value for the case of finite values of x < 1 If the MX option is supported the PCD shall document the return value for the case when x is -Inf. aio_cancel If the AIO option is supported The PCD shall document which asynchronous I/O operations are cancelable. asin,asinf,asinl The PCD shall document the return value for the case of finite values of x not in the range [-1,1] If the MX option is supported the PCD shall document the return value for the case when x is +/-Inf. atanh,atanhf,atanhl The PCD shall document the return value for the case of finite values of |x| > 1 If the MX option is supported the PCD shall document the return value for the case when x is +/-Inf. 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 as either being a null pointer or a unique pointer. chmod The PCD shall document any additional restrictions that may cause the S_ISUID and S_ISGID bits in mode to be ignored. The PCD shall document the effect on file descriptors for files open at the time of a call to chmod(). 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 another process. clock_getres If the TMR option is supported The PCD shall document the resolution of the supported clocks. 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 required to set a particular clock. close If the AIO option is supported the PCD shall document whether any outstanding I/O operations are canceled upon close(). closelog,openlog,setlogmask,syslog (If the XSI option is supported [This feature Requ'd for PSE54]) the PCD shall document the logging facility and if applicable the system log. cos,cosf,cosl If the MX option is supported the PCD shall document the return value for the case when x is +/-Inf. dlopen (If the XSI option is supported:[ This feature requ'd for PSE54]) The PCD shall document the class of files eligible for use with the dlopen() function. The PCD shall document the manner of construction of files eligible for use with the dlopen() function. The PCD shall document how the file argument when it does not contain a slash character is used to generate a pathname. The PCD shall document when relocations shall be performed in the case that the mode parameter is RTLD_LAZY. erfc,erfcf,erfcl The PCD shall document the return value for the case of a correct value that would cause underflow and is not representable. 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. If the PS option is supported the PCD shall document the effects of the policy and priority settings on exec. If the AIO option is supported the PCD shall document whether any outstanding I/O operations are canceled upon an exec call. The PCD shall document the inheritance of process attributes not defined by the System Interfaces volume of IEEE Std 1003.1-2001. exit,_Exit,_exit for _Exit and _exit The PCD shall document whether open streams are flushed or closed, or temporary files are removed on a call to _Exit() or _exit(). 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. If the AIO option is supported the PCD shall document whether any outstanding I/O operations are canceled upon _Exit() or _exit(). exp,expf,expl The PCD shall document the return value for the case when the correct value would cause underflow and is not representable. exp2,exp2f,exp2l The PCD shall document the return value for the case when the correct value would cause underflow and is not representable. 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 /cmd/ defined in . Their names shall start with F_. fdim,fdimf,fdiml The PCD shall document the return value for the case when x-y is positive and underflows fegetexecptflag The PCD shall document the 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. fma,fmaf,fmal If the MX option is supported: The PCD shall document the return value for the case when x multiplied by y is an exact infinity and z is also an infinity but with the opposite sign The PCD shall document the return value for the case when one of x and y is infinite, the other is zero, and z is not a NaN an infinity but with the opposite sign fmod,fmodf,fmodl The PCD shall document the return value for the case when the correct value would cause underflow and is not representable. If the MX option is supported, the PCD shall document the return value for the case when y is zero. If the MX option is supported, the PCD shall document the return value for the case when x is infinite. fork If the PS option is supported The PCD shall document the policy and priority settings on fork() for scheduling policies other than SCHED_FIFO and 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 numbers in double format. The PCD shall document whether the style for representing double argument infinity values for the f conversion specifier is "[-]inf" or "[-]infinity". The PCD shall document whether the style for representing double argument infinity values for the F conversion specifier is "[-]INF" or "[-]INFINITY". The PCD shall document whether the style for representing double argument 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 double argument 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 character 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. 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 The PCD shall document, for implementations that provide additional or alternative file access control mechanisms, any conditions that cause fstat() to fail beyond those specified in IEEE Std 1003.1-2001. 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 numbers in double format. The PCD shall document whether the style for representing double argument infinity values for the f conversion specifier is "[-]inf" or "[-]infinity". The PCD shall document whether the style for representing double argument infinity values for the F conversion specifier is "[-]INF" or "[-]INFINITY". The PCD shall document whether the style for representing double argument 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 double argument 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. kill For implementations that provide extended security controls, the PCD shall document further implementation-defined restrictions on the sending of signals, including the null signal, if any. ldexp,ldexpf,ldexpl The PCD shall document the return value for the case when the correct value would cause underflow and is not representable. listen For implementations where a backlog argument of 0 allows the socket to accept connections, the PCD shall document the length of the minimum value of the listen queue. log,logf,logl The PCD shall document the return value for the case when the finite values of x are less than zero If the MX option is supported, the PCD shall document the return value for the case when the x is -Inf log10,log10f,log10l The PCD shall document the return value for the case when the finite values of x are less than zero If the MX option is supported, the PCD shall document the return value for the case when the x is -Inf log1p,log1pf,log1pl The PCD shall document the return value for the case when the finite values of x are less than -1 If the MX option is supported, the PCD shall document the return value for the case when the x is -Inf log2,log2f,log2l The PCD shall document the return value for the case when the finite values of x are less than 0 If the MX option is supported, the PCD shall document the return value for the case when the x is -Inf 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 as either being a null pointer or a unique pointer. 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 on the amount of memory that the process may lock. mlockall,munlockall 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 another limit. In addition the PCD shall 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 on the amount of memory that the process may lock. mmap If the MF or SHM or TYM options are supported: The PCD shall document the return value for the mmap() function. The PCD shall document whether MAP_FIXED is supported. The PCD shall document how the implementation uses /addr/ to arrive at /pa/ when MAP_FIXED is not set. If there are limits on the number of memory regions that can be mapped then the PCD shall document them. mq_open If the MSG option is supported: The PCD shall document the effect of calling mq_open when the name argument does not begin with a slash character. The PCD shall document the interpretation of the name argument when it contains additional slash characters other than the leading slash character. The PCD shall document the effect when bits in mode other than file permission bits are set The PCD shall document the default message queue attributes for a created message queue when mq_open is called with attr set to NULL. mq_receive If the MSG option is supported: The PCD shall document the result if the value of msg_len is greater than {SSIZE_MAX}. mq_setattr If the MSG option is supported: The PCD shall document whether any implementation flags are OR'd with O_NONBLOCK for the mq_flags member. nice If the PS or TPS options are supported the PCD shall document the effect on processes or threads with other scheduling policies than SCHED_FIFO or SCHED_RR. 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 if the memory object specified by fildes is not a typed memory object. posix_spawn,posix_spawnp If the SPN option is supported: For posix_spawnp 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. If the THR option is supported the PCD shall document whether the fork handlers are run when posix_spawn( ) or posix_spawnp( ) is called. posix_spawnattr_destroy If the SPN option is supported: If the implementation supports attributes not defined by IEEE Std 1003.1-2001, their default values, and the names of the associated functions to get and set those attribute values shall be documented in the PCD. posix_trace_attr_getlogsize If the TRC option is supported: If the TRL option is supported, the PCD shall document the default value for the log-max-size attribute. posix_trace_attr_getmaxdatasize If the TRC option is supported: The PCD shall document the default value for the max-data-size attribute. posix_trace_attr_getlogstreamsize If the TRC option is supported: The PCD shall document the default value for the stream-min-size attribute. posix_trace_create_withlog If the TRC option is supported: If the TRL option is supported, the PCD shall document the list of the appropriate file types that are compatible with each log policy for the log-max-size attribute. posix_trace_flush,posix_trace_shutdown If the TRC option is supported, the PCD shall document the maximum file size of the trace log file. posix_trace_eventset If the TRC and TEF options are supported, the PCD shall include a description of all the process-independent implementation-defined system trace event types. If the TRC and TEF options are supported, the PCD shall include a description of all implementation-defined system trace event types. posix_trace_getnext_event,posix_trace_trygetnext_event posix_trace_timedgetnext_event If the TRC option is supported, the PCD shall document the time resolution that causes the ordering of trace events occurring very close to each other to be unknown. posix_typed_mem_get_info If the TYM option is supported: The PCD shall document additional information returned in other fields of the posix_typed_mem_info structure pointed to by info, if any. posix_typed_mem_open If the TYM option is supported: The PCD shall document the effect of calling posix_typed_mem_open when the name argument does not begin with a slash character. The PCD shall document the interpretation of the name argument when it contains additional slash characters other than the leading slash character. The PCD shall document the manner for binding between names and typed memory objects. The PCD shall document the appropriate privilege to specify the POSIX_TYPED_MEM_MAP_ALLOCATABLE flag pow,powf,powl The PCD shall document the return value for the case when the finite values of x are less than 0 and finite non-integer values of y The PCD shall document the return value for the case when the correct value would cause underflow and is not representable 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 an out of band data mark in the receive queue, the PCD shall document the circumstances under which a socket may be considered to have an exceptional condition pending. pthread_attr_destroy If the THR option is supported, and the implementation of the pthread_attr_destroy sets attr to an invalid value, the PCD shall document the value used. pthread_barrierattr_getpshared If the THR and BAR options are supported if the implementation supports barrierattr attributes not defined by IEEE Std 1003.1-2001, their default values, and the names of the associated functions to get and set those attribute values shall be documented in the PCD. pthread_condattr_destroy If the THR option is supported if the implementation supports condition variable attributes not defined by IEEE Std 1003.1-2001, their default values, and the names of the associated functions to get and set those attribute values shall be documented in the PCD. pthread_getschedparam,pthread_setschedparam If the THR and TPS options are supported the PCD shall document the affected scheduling parameters when the scheduling policy is SCHED_OTHER. If the TSP option is supported, the PCD shall document whether the pthread_setschedparam( ) function is supported if the scheduling policy was not SCHED_SPORADIC at the time of the call. pthread_rwlock_rdlock If the THR option is supported and the TPS 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. If the THR option is supported the PCD shall document the maximum number of simultaneous read locks that an implementation guarantees can be applied to a read-write lock. pthread_rwlock_unlock If the THR option is supported and the TPS option is not supported the PCD shall document whether write locks take precedence over read locks. pthread_rwlockattr_getpshared If the THR option is supported if the implementation supports read-write lock attributes not defined by IEEE Std 1003.1-2001, their default values, and the names of the associated functions to get and set those attribute values shall be documented in the PCD. 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}. remainder,remainderf,remainderl If the MX option is supported, the PCD shall document the return value in the case when x is infinite or y is zero and the other is non-NaN. 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 MX option is supported, the PCD shall document the return value for the case when x is +/-Inf or y is zero and the other argument is non-zero. rint,rintf,rintl The PCD shall document how the current rounding mode is determined. scalbln,scalblnf,scalblnl,scalbn,scalbnf,scalbnl The PCD shall document the return value when the correct value would cause underflow and is not representable sched_setparam If the PS 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 PS and SS options are supported, the PCD shall document the effects of the sched_ss_low_priority, sched_ss_repl_period, and sched_ss_init_budget members of the param argument when the scheduling policy of this process is not SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC. If the PS option is supported the PCD shall document the result when the current scheduling policy for the process specified by pid is not SCHED_FIFO, SCHED_RR, or SCHED_SPORADIC (if the SS option is supported). sched_setscheduler If the PS option is supported, the PCD shall document the conditions under which one process has permission to change the scheduling parameters of another process . sem_open If the SEM option is supported: The PCD shall document the effect of calling sem_open when the name argument does not begin with a slash character. The PCD shall document the interpretation of the name argument when it contains additional slash characters other than the leading slash 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 effect of calling shm_open when the name argument does not begin with a slash character. The PCD shall document the interpretation of the name argument when it contains additional slash characters other than the leading slash 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 MX option is supported, the PCD shall document the return value for the case when x is +/-Inf. socket The PCD shall document the address families supported by the system. The PCD shall document the protocols supported by the system. sqrt,sqrtf,sqrtl The PCD shall document the return value for the case of finite values of x < -0. If the MX option is supported the PCD shall document the return value for the case when x is -Inf. stat The PCD shall document, for implementations that provide additional or alternative file access control mechanisms, any conditions that cause stat() to fail beyond those specified in IEEE Std 1003.1-2001. strtod,strtof,strtol The PCD shall document the meaning of the n-char sequences. If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. strtol,stroll If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. strtoul,stroull If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. 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 The PCD shall document the return value in the case when the correct value would cause underflow and is not representable. If the MX option is supported, the PCD shall document the return value for the case when x is +/-Inf. 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. tempnam On implementations which use tempnam() internally, the PCD shall document the behavior if the function is called more than {TMP_MAX} times in a single process. tgamma,tgammaf,tgammal The PCD shall document the return value for the case when x is a negative integer. If the MX option is supported, the PCD shall document the return value for the case when x is -Inf. timer_create If the TMR option is supported, the PCD shall document whether a timer_create( ) function will succeed if 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. 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. 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. If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. wcstol,wcstoll If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. wcstoul,wcstoull If other subject sequences beyond those specified are accepted in other locales than the C or POSIX locale, the PCD shall document them. 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 any additional circumstances to those specified for an [EIO] error to be returned. Shell and Utilities 1.7 Relationship to Other Documents 1.7.1 System Interfaces 1.7.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.7.1.5 File removal The PCD shall document the effect of removing a directory that is the root directory of current working directory of any process. 2. Shell Command Language 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 asa If the FR option is supported: The PCD shall document how the asa utility maps carriage-control characters from the text files to line-printer control sequences. The PCD shall document the characters that are output to cause an advance to the next page in the case that the character removed is 1. The PCD shall document the characters that are output to cause printing to return to column position 1 in the case that the character removed is +. at If the Up option is supported The PCD shall document other execution-time attributes that are in effect beyond those specified at the time the at utility is executed. The PCD shall document the meanings of all other queuenames, besides queues /a/ and /b/. The PCD shall document the acceptable timezone names for the time operand. 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 the interactions of the -g option, if any, with other options. The PCD shall document additional names, if any, provided by the compiler, as if by the -D option. The PCD shall document whether the implementation recognizes files ending in suffixes other than .a as denoting object file libraries. The PCD shall document whether the implementation recognizes files ending in suffixes other than .o as denoting object files. The PCD shall document whether the implementation processes other file operands other than those ending the suffixes .c, .a and .o. The PCD shall document whether the implementation recognizes files ending in suffixes other than .a as denoting a library. The PCD shall document additional input file formats recognized by the c99 utility other than those specified, if any. The PCD shall document the action taken if an external symbol is encountered that exceeds the maximum symbol length. The PCD shall document the limit on the number of external symbols per source or object files. The PCD shall document the limit on the number of external symbols in total. cat The PCD shall document whether the cat utility buffers output if the -u option is not specified. 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 regulae 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. command If the UP option is supported: The PCD shall document any functions beyond those specified that are found using the PATH variable. cp The PCD shall document the behavior of cp when source_file is a file of type symbolic link and the -r option is specified. 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-2001. The PCD shall document the behavior of cp 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. 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. The PCD shall document of the -r option the treatment of special files. crontab If the UP option is supported The PCD shall document the method by which any generated output or errors are mailed to the user. ctags If the UP option is supported: The PCD shall document whether the ctags utility handles file operands with suffixes other than .c, .h or .f. The PCD shall document what other objects (including duplicate identifiers) besides those specified that produce output. df If the UP option is supported: The PCD shall document the format of the STDOUT field. The PCD shall document the exact meaning of the STDOUT field. 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. dirname The PCD shall document whether steps 7 and 8 (of the DESCRIPTION) are skipped or processed when the remaining string is // . echo The PCD shall document the results of the first operand being -n, or any of the operands containing a backslash character. ed For the List command, if the size of a byte on the system is greater than nine bits, the PCD shall document the format used. ex If the UP option is supported: The PCD shall document the set of user IDs, if any, other than the same user ID as the real user ID of the process that the .exrc file in the current directory can be owned by for the ex editor to attempt to execute the commands in the file. For -V , the PCD shall document whether a character other than -V performs its function , if the ``literal next'' functionality is performed by the underlying system. For -W, the PCD shall document whether a character other than -W performs its function, if the "word erase" functionality is performed by the underlying system. For Abbreviate, the PCD shall document any additional restrictions on the set of characters in the lhs and rhs arguments . For Change Directory, the PCD shall document the default value of the directory to change directory to if no directory argument is given and if the HOME environment variable is empty or is undefined. For Map, the PCD shall document any additional restrictions on the set of characters in the lhs and rhs arguments . For Mark, the PCD shall document the support, if any, of other characters beyond those specified for the Mark character. For Print, the PCD shall document the multi-character sequences written for non-printable characters other than the character. For Print , if the size of a byte on the system is greater than nine bits, the PCD shall document the format used for non-printable characters. For Write, the PCD shall document additional tests beyond those specified, if any, that would cause the write to fail. The PCD shall document the default value of the directory edit option. The PCD shall document if there are reasons why the readonly edit option is initialized to set beyond those specified. The PCD shall document information beyond that specified that is displayed when showmode is set in open or visual modes. The PCD shall document whether the baud rate changes the default number of lines for the window edit option. The PCD shall document the effect of the wrapmargin edit option for locales other than the POSIX locale. fc If the UP option is supported: The PCD shall document the upper limit at which the shell wraps the command history number. This number shall be shall be no smaller than the value in HISTSIZE or 32 767 (whichever is greater). The PCD shall document any system startup files that initialize the history file, if any. The PCD shall document whether changes made to the HISTFILE environment variable after the history file is initialized are effective. The PCD shall document whether there are circumstances and if so what they are, under which the history list mechanism is disabled for users with appropriate privileges who do not set HISTFILE. file If the UP option is supported: The PCD shall document the file types beyond those specified, if any, that can be identified by the file utility. If the CD option is not supported, the PCD shall document the default sizes (number of bytes) for the type specifiers, d,f, and u. The PCD shall document the byte order when interpreting numeric values for the type field. If the size of a byte on the system is greater than 9 bits, then the PCD shall document the valid escape sequence used to represent a byte for the value field. find The PCD shall document whether find replaces those two characters or uses the string without change, when a utility_name or argument string contains the two characters "{}", but not just the two characters "{}". fort77 If the FD option is supported: The PCD shall document the interactions of the -g option with other options, if any. The PCD shall document suffixes other than .a that fort77 recognizes as denoting object file libraries. The PCD shall document suffixes other than .o that fort77 recognizes as denoting object files . The PCD shall document whether fort77 processes files with suffixes other than .f, .a and .o. The PCD shall document suffixes other than .a that fort77 recognizes as denoting libraries. The PCD shall document additional input file formats recognized by the fort77 utility other than those specified, if any. The PCD shall document the action taken if an external symbol is encountered that exceeds the maximum symbol length. The PCD shall document the limit on the number of external symbols per source or object files. The PCD shall document the limit on the number of external symbols in total. The PCD shall document whether an object module is created when fort77 encounters a compilation error. 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 format of the lex statistics written to either standard error or standard output when the -v option is specified and the -n option and -t option are not specified. The PCD shall document the format of informational, error, and warning messages concerning the contents of lex source code written to standard error or standard output when the -t option is specified. The PCD shall document the format of informational, error, and warning messages concerning the contents of lex source code written to standard error or standard output when the -t option is not specified. The PCD shall document the default type for yytext. The PCD shall document the exact meaning of the table size numbers given in table 4-9. This includes documenting 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. If the size of a byte on the system is greater than 9 bits, then the PCD shall document the valid escape sequence used to represent a byte for the escape sequence on table 4-10. 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-2001, if any. 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 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 slash 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 the -a option to ls 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,if applicable, the information about devices that replaces the size of the file, for character special and block special files The PCD shall document additional characters used for the character to describe the type of file, beyond those specified, if any. mailx The PCD shall document how messages that are not text files are stored in files written by mailx. The PCD shall document the name of the system startup file. The PCD shall document the default value of the crt internal mailx variable when it is unset. 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 other files that are tried if neither ./makefile and ./Makefile are not found. The PCD shall document the interpretation of targets containing the characters '%' and '"'. The PCD shall document the manner of quoting used to add all of the make utility command line options (except -f and -p) and make utility command line macro definitions (except any for the MAKEFLAGS macro), not already included in the MAKEFLAGS macro, such that when MAKEFLAGS is read by another instance of the make command, the original macro's value is recovered. The PCD shall document addition options and macros added to the MAKEFLAGS macro, if any. The PCD shall document any additional variables added to the environment of make beyond those specified, if any. The PCD shall document the effect of defining SHELL in the makefile or on the command line beyond those specified, if any. 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 to display a when the -u option is specified. The PCD shall document how other non-printable characters are written besides those specified. (note it should be the same format as for the ex print command) The PCD shall document how much backwards motion is supported in the case that text being displayed is being taken from a non-rewindable stream, such as a pipe. The PCD shall document any commands beyond those specified that the help summary covers. For Invoke Editor, 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-2001, if any. newgrp If the UP option is supported The PCD shall document whether users not listed as members of that group can change to that group when no password is required for the specified group. The PCD shall document whether there are any system accounting or security mechanisms that may cause newgrp to write a diagnostic message and suppress the changing of the group identification. nice If the UP option is supported The PCD shall document the nice value that the executed utility is run with, when no options are specified and the user has appropriate privilege. nm If the UP and SD options are supported The PCD shall document any additional object library formats for the input file beyond those specified. The PCD shall document any additional single character Symbol types beyond those specified (for standard output) od The PCD shall document the byte order when interpreting numeric values. If the size of a byte on the system is greater than nine bits, the PCD shall document the format used for non-printable characters. 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. 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-2001. 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. 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 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 if the -oinvalid=UTF-8 option is not specified. The PCD shall document the encodings of the characters, if an implementation supports the use of characters outside of slash 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 interchange format. The PCD shall document the format of the c_rdev field for the cpio interchange format. ps If the UP option is supported The PCD shall document the format for terminal identifiers used the -t option. The PCD shall document whether any further truncation occurs of the output of the args command beyond that specified. renice If the UP option is supported The PCD shall document the bounding of the nice value. sed For the l (ell) command, if the size of a byte on the system is greater than nine bits, the PCD shall document the format used for non-printable characters. 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 system startup files that initialize the history file, if any. If the UP option is supported The PCD shall document whether there are circumstances and if so what they are, under which the history list mechanism is disabled for users with appropriate privileges who do not set HISTFILE. strings If the UP option is supported: The PCD shall document additional strings other than those specified, if any, that the strings utility writes. The PCD shall document the portion of files scanned for strings if 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, if any. talk If the UP option is supported: The PCD shall document the existence and processing of additional special control characters and multi-byte or single-byte functions 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 other non-printable characters other than those specified are typed. test The PCD shall document Additional operators and primary_operators provided, if any. touch The PCD shall document the range of valid times past the Epoch tput If the UP option is supported: The PCD shall document the manner in which the init operand causes tput to initialize the user' terminal. The PCD shall document the manner in which the reset operand causes tput to reset the user' terminal. tr If the size of a byte on the system is greater than nine bits, the PCD shall document the format used to represent characters with specific coded values. 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 additional symbols written beyond those specified, if any, when the -a option is specified. vi If the UP option is supported: The PCD shall document whether other characters besides brackets and curly braces, are searched for and matched as equivalent. For the command, 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 For the command, 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. For the command, 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. For the command, 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. For the command, 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. For the command, 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. who If the UP option is supported: The PCD shall document the domain of accessibility for the who utility. The PCD shall document the default output format. write If the UP option is supported: The PCD shall document the existence and processing of additional special control characters and multi-byte or single-byte functions 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 other non-printable characters other than those specified are typed. yacc If the CD option is supported: The PCD shall document how Limits for internal tables (see Limits table 4-22 (on page 1075)) are reported. The PCD shall document the exact meanings of the limits values in table 4-22.