Draft POSIX Conformance Template for Austin-182r1 Page 1 of 1 the 1003.1, 2003 Edition Submitted by Andrew Josey, The Open Group. October 31, 2003 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.62 Batch Queue Priority If the Batch Services Environment is supported , the PCD shall document how the batch queue priority is bounded. 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.15 Semaphore If XSI Semaphores are supported, the PCD shall document the maximum number of semaphores in a semaphore set. 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. If the XSI option is supported, the PCD shall document the possible settings of language, territory, and codeset for locale values of the form language[_territory][.codeset] 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 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. If the XSI option is supported the PCD shall document the value of NL_SETD. 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. If the XSI option is supported The PCD shall document any abnormal termination actions beyond those specified. The PCD shall document the values for the limits of specified-width integer types. The PCD shall document the values of the following macros: PTRDIFF_MIN, PTRDIFF_MAX, SIG_ATOMIC_MIN, SIG_ATOMIC_MAX, SIZE_MAX, WCHAR_MIN, WCHAR_MAX, WINT_MIN, WINT_MAX If the XSR option is supported the PCD shall document what information is sent about another STREAM when the I_FDINSERT macro is defined for use as the request argument to ioctl(). 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 XSI or RTS options are 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. catgets If the XSI option is supported the PCD shall document the security criteria that can cause an [EBADMSG] error to occur. catopen If the XSI option is supported the PCD shall document the default path used when NLSPATH does not exist in the environment, or if a message catalog cannot be found in any of the components specified by NLSPATH chmod The PCD shall document any additional restrictions that may cause the S_ISUID and S_ISGID bits in mode to be ignored. 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 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. crypt If the XSI option is supported the PCD shall document the algorithm for the crypt() function. dlopen If the XSI option is supported: 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. ecvt,fcvt,gcvt If the XSI option is supported the PCD shall document for ecvt() the manner in which the low-order digit is rounded. encrypt If the XSI option is supported the PCD shall document the encoding algorithm endgrent,getgrent,setgrent If the XSI option is supported If an implementation provides extended security controls, the PCD shall document any further restrictions on accessing the group database. endpwent,getpwent,setpwent If the XSI option is supported If an implementation provides extended security controls, the PCD shall document any further restrictions on accessing the user database. endutxent,getutxent,getutxid,getutxline,pututxline,setutxent If the XSI option is supported The PCD shall document the name of the login process (for the ut_user member) If an implementation provides extended security controls, the PCD shall document any further restrictions on accessing the user accounting database. 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(). If the XSI option is supported, the PCD shall document whether a SIGCHLD signal is sent to the parent process when SA_NOCLDWAIT is set. 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. getrlimit If the XSI option is supported, the PCD shall document how an implemention determines whether a limit can be correctly represented in an object of type rlim_t. glob The PCD shall document the contents of pglob->gl_pathv, when the pattern does not match any pathnames. iconv If the XSI option is supported, the PCD shall document the conversion performed when iconv( ) encounters a character in the input buffer that is valid, but for which an identical character does not exist in the target codeset. iconv_open If the XSI option is supported, the PCD shall document the settings of fromcode and tocode and their permitted combinations. ioctl If the XSR option is supported: The PCD shall document the value of the timeout interval, when ic_timeout is zero for the I_STR ioctl command. The PCD shall document the default timeout interval used for the STREAM head delay when a STREAM is closing and there is data in the write queues and I_SETCLTIME has not been performed on the STREAM. The PCD shall document the default timeout interval for the I_LINK, I_UNLINK, I_PLINK, and I_PUNLINK commands. 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. mknod If the XSI option is supported, 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. 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. If the XSI option is not supported 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. If there are limits on the number of memory regions that can be mapped, and the XSI option is supported, then the PCD shall document whether the use of shmat() decreases the number available. 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. msgrcv If the XSI option is supported: The PCD shall document the result of calling msgrcv() when the value of msgsz is greater than {SSIZE_MAX}. 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. If the XSI option is supported, the PCD shall document whether the function restarts or returns with [EINTR] when SA_RESTART has been set for the interrupting signal. 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}. realpath If the XSI option is supported The PCD shall document the behavior of realpath( ) when the resolved_name argument is a null pointer. 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. scalb If the XSI option is supported: The PCD shall document the return value when x is +/-0 and n is +Inf. The PCD shall document the return value when x is +/-Inf and n is -Inf. 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. semop If the XSI option is supported, the PCD shall document any extensions to the XSI semaphore operations. setkey If the XSI option is supported, the PCD shall document the encoding algorithm for setkey(). 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 If the XSI option is supported, the PCD shall document system specific additional error information, if any. 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. strptime If the XSI option is supported The PCD shall document the result of a strptime() call when the value of maxsize is greater than {SSIZE_MAX}. 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 If the XSI option is supported: The PCD shall document which if any directory is used if the directory defined as P_tmpdir in is not accessible. 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. If the XSI option is supported, the PCD shall document the process ID corresponding to a system process that inherits any children that are not waited for when a parent process terminates. 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.] 3. Batch Environment Services If the BE option is supported: 3.1.5 Batch Job Routing The PCD shall document the algorithm by which a batch server selects a batch queue to which to route a batch job. The PCD shall document the reasons for rejecting a batch job. The PCD shall document the reasons for which the routing should be retried later and the reasons for which a job should be aborted. 3.1.6 Batch Job Execution The PCD shall document other means than those specified by which an implementation may pass the script to the program , if any. The PCD shall document the algorithm by which the batch server selects eligible jobs for execution. 3.2.1 Batch Job States The PCD shall document the treatment of jobs with the Execution_Time or Hold_Types attributes in a routing queue. 3.2.2 Deferred Batch Job Services 3.2.2.1 Batch Job Execution The PCD shall document other means than those specified by which an implementation may pass the script to the program , if any. The PCD shall document the algorithm for scheduling jobs . The PCD shall document the batch server action for the case when the Account_Name attribute of the batch job is absent from the batch job attribute list or is altered while the batch job is in execution. The PCD shall document the behavior when a batch server executes a batch job for which the value of the Checkpoint attribute is CHECKPOINT_UNSPECIFIED. The PCD shall document the location for placing the standard error for the case when the batch server buffers the standard error of the batch job and the file cannot be opened for write upon completion of the batch job. The PCD shall document any additional hold types, how they are specified, their internal representation, their behavior, and how they affect the behavior of other utilities. The PCD shall document the names of the files retained in the user's home directory in the case that the Keep_Files attribute includes values other than KEEP_STD_OUTPUT and KEEP_STD_ERROR. The PCD shall document whether or not the batch server buffers the standard output of the batch job until completion of the batch job. The PCD shall document the location for placing the standard output for the case when the batch server buffers the standard output of the batch job and the file cannot be opened for write upon completion of the batch job. The PCD shall document the interpretation of the batch job Priority attribute by a batch server. The PCD shall document the method for how batch resource limits are enforced. The PCD shall document the path used by the batch server to expand the path in the case when the value of the selected pathname from the Shell_Path_List attribute of the batch job represents a partial path. 3.2.2.2 Batch Job Routing The PCD shall document the algorithm for selecting a batch job and the queue to which it will be routed. The PCD shall document the precedence of the destinations when a routing queue has multiple possible destinations specified. The PCD shall document the means by which an administrator specifies the number of retries and the delay between retries. 3.2.2.3 Batch Job Exit If the batch server cannot return the standard error output and/or standard output file, and the batch server notifies the user by means other than those specified it shall be documented in the PCD. 3.2.3 Requested Batch Services 3.2.3.1 Delete Batch Job Request The PCD shall document any reasons other than those specified why a batch server may reject a Delete Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. The PCD shall document whether additional signals are sent to the session leader of the job prior to sending the SIGKILL signal when deleting a batch job in the RUNNING state. 3.2.3.2 Hold Batch Job Request The PCD shall document any reasons other than those specified for why a batch server may reject a Hold Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. The PCD shall document the effects, if any, the hold will have on a batch job in the RUNNING state. 3.2.3.3 Batch Job Message Request The PCD shall document any reasons other than those specified for why a batch server may reject a Batch Job Message Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.4 Batch Job Status Request The PCD shall document any reasons other than those specified for why a batch server may reject a Batch Job Status Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.5 Locate Batch Job Request If POSIX2_PBS_LOCATE is set to 1 The PCD shall document any reasons other than those specified for why a batch server may reject a Locate Batch Job Request. 3.2.3.6 Modify Batch Job Request The PCD shall document any reasons other than those specified for why a batch server may reject a Modify Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.7 Move Batch Job Request The PCD shall document any reasons other than those specified for why a batch server can reject a Move Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.8 Queue Batch Job Request The PCD shall document the "default queue" selected for a batch job in the case when a batch server is requested to queue a batch job for which the queue is not specified. The PCD shall document any reasons other than those specified for why a batch server can reject a Queue Batch Job Request. 3.2.3.9 Batch Queue Status Request The PCD shall document any reasons other than those specified for why a batch server can reject a Batch Queue Status Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.10 Release Batch Job Request The PCD shall document any reasons other than those specified for why a batch server can reject a Release Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.11 Rerun Batch Job Request The PCD shall document any reasons other than those specified for why a batch server can reject a Rerun Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. The PCD shall document whether and how the batch job owner is notified that a batch job is rerun. The PCD shall document the signals, if any, that the batch server that reruns a batch job sends to the session leader of the batch job prior to sending the SIGKILL signal. The PCD shall document whether rerun jobs are selected for execution before other jobs. 3.2.3.13 Server Shutdown Request The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. The PCD shall document any reasons other than those specified for why a batch server can reject a Server Shutdown Request. 3.2.3.14 Server Status Request The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. The PCD shall document any reasons other than those specified for why a batch server can reject a Server Status Request. 3.2.3.15 Signal Batch Job Request The PCD shall document any reasons other than those specified for why a batch server can reject a Signal Batch Job Request. The PCD shall document the method used to determine whether the user of a client is authorized to perform the requested action. 3.2.3.16 Track Batch Job Request If POSIX2_PBS_TRACK is set to 1 The PCD shall document the method by which backup servers are specified. 3.3 Common Behavior for Batch Environment Utilities 3.3.1 Batch Job Identifier The PCD shall document the means by which a utility determines the default batch server. 3.3.2 Destination The PCD shall document the means by which a batch server determines its default queue. 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. cxref If the XSI option is supported: The PCD shall document other single-character flags and their meanings in the standard output, if any. 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 If the XSI option is not supported 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. gencat If the XSI option is supported: The PCD shall document the default message set NL_SETD where all messages are located if no $set directive is specified in a message text source file. The PCD shall document the effect of lines in a message text file starting with any character other than those specified. 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. If the XSI option is supported, the PCD shall document the block size used for the display associated with the -s option. 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. If the XSI option is supported, the PCD shall document the precise meanings of the output fields. The PCD shall document whether any further truncation occurs of the output of the args command beyond that specified. qalter+ If the BE option is supported The PCD shall document the effect of an attempt to alter the attributes of a batch job in the RUNNING state. The PCD shall document the interpretation of mail_address for use with the -M option for the qalter and qsub utilities The PCD shall document whether the implementation defines other hold types than those specified for the qalter , qhold, qrls and qselect utilities, and if so describe their internal behavior and how they affect the behavior of these utilities. The PCD shall document whether the implementation defines other join types than those specified for the qalter and qsub utilities, and if so describe their internal behavior and how they affect the behavior of these utilities. The PCD shall document whether the implementation defines other keep types other than those specified for the qalter and qsub utilities, and if so describe their internal behavior and how they affect the behavior of these utilities. The PCD shall document whether the implementation defines other mail types other than those specified for the qalter and qsub utilties, and if so describe their internal behavior and how they affect the behavior of these utilities. The PCD shall document whether the qalter utility attempts to locate a batch job on other servers. qdel + If the BE option is supported The PCD shall document whether the qdel,qhold,qmove,qmsg,qrerun,qrls,qsig and qstat utilities wait to output a diagnostic message while attempting to locate a job on other servers. The PCD shall document whether the qdel qhold qmove qmsg qrerun qrls qsig qstat utilities output a diagnostic while attempting to locate the job on other servers. qmsg If the BE option is supported The PCD shall document the name and location of the implementation-defined file that the qmsg utility writes the message to if neither -O nor the -E options are specified. qselect If the BE option is supported The PCD shall document the format that the qselect utility supports for matching against the Job_Name attribute for the -N option The PCD shall document how the qselect utility determines the default batch server qstat If the BE option is supported The PCD shall document additional implementation-defined information, if any, about the batch job or batch queue displayed for the -f option to the qstat utility. qsub If the BE option is supported The PCD shall document the value of the Priority attribute if the -p option is not presented to the qsub utility. The PCD shall document the default destination if the -q option is not presented to the qsub utility The PCD shall document the mechanism for setting and determining the value of the default shell for the qsub utility. The PCD shall document the format of shell commments recognized by the qsub utility for the script file argument. 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. uncompress If the XSI option is supported The PCD shall document whether values of -b greater than 14 are supported. uucp If the XSI option is supported The PCD shall document the actual location of the PUBDIR directory. The PCD shall document the read, write, and execute permissions given by uucp 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. If the XSI option is supported The PCD shall document the database used for the -a option when no file operand is given. 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.