POSIX Conformance Template for the 1003.1-2003 Base Product Standard Submitted by Andrew Josey, The Open Group. October 31, 2003 POSIX Conformance Document template for 1003.1-2003 Base Product Standard 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.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.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.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.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. 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 the special file, if any 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 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. 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. 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.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.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. 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]. acosh,acoshf,acoshl The PCD shall document the return value for the case of finite values of x < 1 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] atanh,atanhf,atanhl The PCD shall document the return value for the case of finite values of |x| > 1 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. 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. 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. 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. fmod,fmodf,fmodl The PCD shall document the return value for the case when the correct value would cause underflow and is not representable. 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 log10,log10f,log10l The PCD shall document the return value for the case when the finite values of x are less than zero log1p,log1pf,log1pl The PCD shall document the return value for the case when the finite values of x are less than -1 log2,log2f,log2l The PCD shall document the return value for the case when the finite values of x are less than 0 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. 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. 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. 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}. 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. 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 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 "". 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. 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. 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. 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 The PCD shall document the return value for the case when x is a negative integer. 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 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 "//". 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. 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. 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 // . 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. 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 "{}". iconv The PCD shall document valid values of names of the codeset descriptions for the fromcode option-argument to the -f option. 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. 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. 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. 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. 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. stty The PCD shall document default options for a terminal The PCD shall document any special control characters beyond those specified, if any. 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 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.