Hi! ----
Below is an overview which manpages need to be changed for ksh93-integration update1 and update2 (the update1 manpage changes have been stalled since April left Sun... ;-( ) and we're now quickly approaching ksh93-integration update2 where "the rules" (I guess C team rules, right ?) require that we can only do a putback near a putback target for the manpage updates. The ksh93-integration update1 (http://arc.opensolaris.org/caselog/PSARC/2008/094/)+ksh93-integration update1 ammendents 1 (http://arc.opensolaris.org/caselog/PSARC/2008/344/) ARC case requires to update the following manpages: kill(1) ksh93(1) logname(1) mkfifo(1) printf(1) rev(1) # new manpage shcomp(1) # new manpage sleep(1) sum(1) test(1) tty(1) typeset(1) I've attched the manpage diffs as "ksh93_update1_mandiffs.txt" ksh93-integration update2 (http://arc.opensolaris.org/caselog/PSARC/2009/063/, http://arc.opensolaris.org/caselog/PSARC/2009/248/)+ksh93-integration "more command conversions" (http://arc.opensolaris.org/caselog/PSARC/2009/249/) require the following manpages: cksum(1) cmp(1) comm(1) cut(1) head(1) join.1 logname(1) mkfifo(1m) paste(1) print(1) # new manpage read(1) tail(1) tee(1) typeset(1) uniq(1) wc(1) I've attched the manpage diffs as "ksh93_update2_mandiffs.txt" Note that there is one overlap between the diffs: "ksh93-integration update1" defined "typeset -C" as "reserved option" (required because the option was already there and being used but we considered it still as a bit "exprimental") while ksh93-integration update2 defines it to declare "compound variables" - the 2nd change is the correct one. Questions: - What information (beyond the diffs) do you and the manpage team need to get the Solaris manual pages updated ? Do you prefer any special format (e.g. DocBook/SolBook, nroff etc.) ? - How does the review process for manpages work like ? - Can you give us any build targets for getting the manual pages updated, please ? ---- Bye, Roland P.S.: CC:/Reply-To:'ing ksh93-integration-discuss at opensolaris.org and docs-discuss at opensolaris.org> -- __ . . __ (o.\ \/ /.o) roland.mainz at nrubsig.org \__\/\/__/ MPEG specialist, C&&JAVA&&Sun&&Unix programmer /O /==\ O\ TEL +49 641 3992797 (;O/ \/ \O;) -------------- next part -------------- # Manpage diff for cd No differences encountered # Manpage diff for jobs No differences encountered # Manpage diff for kill --- kill.1.original.txt Tue Dec 4 16:53:05 2007 +++ kill.1.new.txt Tue Dec 4 21:33:44 2007 @@ -283,12 +283,14 @@ ksh93 ____________________________________________________________ - | ATTRIBUTE TYPE | ATTRIBUTE VALUE | - |______________________________|______________________________| - | Availability | SUNWcsu | - |______________________________|______________________________| - | Interface Stability | Uncommitted | - |______________________________|______________________________| + | ATTRIBUTE TYPE | ATTRIBUTE VALUE | + |______________________________|____________________________| + | Availability | SUNWcsu | + |______________________________|____________________________| + | CSI | enabled | + |______________________________|____________________________| + | Interface Stability | Uncommitted | + |______________________________|____________________________| SEE ALSO csh(1), jobs(1), ksh(1), ksh93(1), ps(1), sh(1), shell_builtins(1), @@ -296,6 +298,10 @@ butes(5), environ(5), standards(5) NOTES + /usr/bin/kill + The number of realtime signals supported is defined by the + getconf value _POSIX_RTSIG_MAX. + sh The Bourne shell, sh, has a built-in version of kill to pro- vide the functionality of the kill command for processes # Manpage diff for logname --- logname.1.original.txt Fri Oct 19 08:24:45 2007 +++ logname.1.new.txt Fri Oct 19 09:08:57 2007 @@ -9,9 +9,14 @@ logname - return user's login name SYNOPSIS - logname + /usr/bin/logname + ksh93 + logname + DESCRIPTION + /usr/bin/logname + The logname utility will write the user's login name to standard output. The login name is the string that would be returned by the getlogin(3C) function. Under the conditions @@ -19,6 +24,15 @@ message to standard error and exit with a non-zero exit status. + ksh93 + logname + + logname writes the users's login name to standard output. + The login name is the string that is returned by the + getlogin(2) function. If getlogin(2) does not return + successfully, the corresponding to the real user id of the + calling process is used instead. + ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of logname: LANG, # Manpage diff for mkfifo --- mkfifo.1.original.txt Fri Oct 19 08:27:33 2007 +++ mkfifo.1.new.txt Fri Oct 19 09:06:41 2007 @@ -11,7 +11,12 @@ SYNOPSIS /usr/bin/mkfifo [-m mode] path... + ksh93 + mkfifo [ options ] file ... + DESCRIPTION + /usr/bin/mkfifo + The mkfifo utility creates the FIFO special files named by its argument list. The arguments are taken sequentially, in the order specified; and each FIFO special file is either @@ -28,7 +33,13 @@ a=rw, modified by the current value of the file mode crea- tion mask umask(1). + ksh93 + + mkfifo creates one or more FIFO's. By default, the mode of + created FIFO is a=rw minus the bits set in the umask(1). + OPTIONS + /usr/bin/ksh93 The following option is supported: -m mode Sets the file permission bits of the newly-created @@ -38,6 +49,10 @@ strings, the op characters + and - will be inter- preted relative to an assumed initial mode of a=rw. + ksh93 + -m, --mode=mode Set the mode of created FIFO to mode. mode + is symbolic or octal mode as in chmod(1). Relative + modes assume an initial mode of a=rw. OPERANDS # Manpage diff for printf --- printf.1.original.txt Thu Nov 22 15:29:21 2007 +++ printf.1.new.txt Mon Dec 3 17:46:47 2007 @@ -17,16 +17,11 @@ DESCRIPTION /usr/bin/printf - The /usr/bin/printf command writes formatted operands to the standard - output. The _a_r_g_u_m_e_n_t operands are formatted under control of - the _f_o_r_m_a_t operand. - - ksh93 printf writes each string operand to standard output using format to control the output format. - The format operands supports the full range of ANSI C formatting specifiers - plus the following additional specifiers: + The format operands supports the full range of ANSI C/C99/XPG6 formatting + specifiers plus the following additional specifiers: %b Each character in the string operand is processed specially as follows: \a Alert character. @@ -69,7 +64,7 @@ will continue to be processed. In addition to the format specifier extensions, the following extensions of - ANSI-C are permitted in format specifiers: + ANSI C/C99/XPG6 are permitted in format specifiers: - The escape sequences \E and \e expand to the escape character which is octal 033 in ASCII. - The escape sequence \cx expands to Control-x. @@ -96,8 +91,8 @@ were supplied, numeric conversions will be treated as if 0 were supplied, and time conversions will be treated as if now were supplied. - printf is equivalent to print -f which allows additional options to be - specified. + /usr/bin/printf is equivalent to ksh93's "printf" built-in and print -f which + allows additional options to be specified. OPERANDS The following operands are supported for /usr/bin/printf: @@ -258,17 +253,12 @@ Notice that this printf utility, like the printf(3C) func- tion on which it is based, makes no special provision for dealing with multi-byte characters when using the %c conver- - sion specification or when a precision is specified in a %b - or %s conversion specification. Applications should be - extremely cautious using either of these features when there + sion specification. Applications should be extremely + cautious using either of these features when there are multi-byte characters in the character set. Field widths and precisions cannot be specified as *. - For compatibility with previous versions of SunOS 5._x, the $ - format specifier is supported for formats containing _o_n_l_y %s - specifiers. - The %b conversion specification is not part of the ISO C standard; it has been added here as a portable way to pro- cess backslash escapes expanded in string operands as pro- @@ -430,6 +420,106 @@ writes the value accumulated at the time the error was detected to standard output. + + Example 6: Alternative floating point representation 1: + The printf utility supports an alternative floating point representation + (see printf(3c) manual page's entry for the "%a"/"%A") which allows + the output of floating-point values in a format which avoids the the + usual base16 to base10 rounding errors. + + example% printf "%a\n" 2 3.1 NaN + + produces: + + 0x1.0000000000000000000000000000p+01 + 0x1.8ccccccccccccccccccccccccccdp+01 + nan + + + Example 7: Alternative floating point representation 2: + The following example shows two different representations of the + same floating-point value: + + example% x=2 ; printf "%f == %a\n" x x + + produces: + + 2.000000 == 0x1.0000000000000000000000000000p+01 + + + Example 8: Output of unicode values + The following command will print the EURO unicode symbol (code-point 0x20ac) + example% LC_ALL=en_US.UTF-8 printf "\u[20ac]\n" + + produces: + + <euro> + (where "<euro>" represents the EURO currency symbol character) + + + Example 9: Convert unicode character to unicode code-point value: + The following command will print the hexadecimal value of a given + character. + + example% export LC_ALL=en_US.UTF-8 + example% printf "%x\n" "'<euro>" + (where "<euro>" represents the EURO currency symbol character + (code-point 0x20ac)) + + produces: + + 20ac + + + Example 10: Print the numeric value of an ASCII character: + printf "%d\n" "'A" + + produces: + + 65 + + + Example 11: To print the language-independent date and time + format, the following statement could be used: + + printf "format" weekday month day hour min + (e.g. $ printf format "Sunday" "July" 3 10 2 + + For American usage, format could be the string: + + "%s, %s %d, %d:%.2d\n" + + producing the message: + + Sunday, July 3, 10:02 + + whereas for EU usage, format could be the string: + + "%1$s, %3$d. %2$s, %4$d:%5$.2d\n" + (note that the '$' charatcers must be propperly escaped, e.g. + "%1\$s, %3\$d. %2\$s, %4\$d:%5\$.2d\n" in this case) + + producing the message: + + Sunnday, 3. July, 10:02 + + +NOTES + Using format specifiers (characters following '%') which are not listed + in the printf(3c) or this manual page will result in undefined behaviour. + + Using escape sequences (the character following a backslash ('\')) which + are not listed in the printf(3c) or this manual page will result in + undefined behaviour. + + Floating-point values follow C99, XPG6 and IEEE 754 standard behaviour + and and can handle values the same way as the platform's |long double| + datatype. + + Floating-point values handle the sign seperately which allows signs + for values like NaN (i.e. -nan), Infinite (i.e. -inf) and zero + (i.e. -0.0). + ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of printf: LANG, LC_ALL, # Manpage diff for read No differences encountered # Manpage diff for rev --- /dev/null Wed Feb 13 05:14:51 2008 +++ rev.1.new.txt Fri Nov 30 00:45:55 2007 @@ -1,0 +1,42 @@ +NAME + rev - reverse the characters or lines of one or more files + +SYNOPSIS + /usr/bin/rev [-l] [file ...] + + ksh93 + rev [-l] [file ...] + +DESCRIPTION + rev copies one or more files to standard output reversing the + order of characters on every line of the file or reversing + the order of lines of the file if -l is specified. + + If no file is given, or if the file is -, rev copies from + standard input starting at the current offset. + +OPTIONS + -l, --line Reverse the lines of the file. + +EXIT STATUS + 0 All files copied successfully. + >0 One or more files did not copy. + +ATTRIBUTES + See attributes(5) for descriptions of the following attri- + butes: + + /usr/bin/rev + ____________________________________________________________ + | ATTRIBUTE TYPE | ATTRIBUTE VALUE | + |_____________________________|_____________________________| + | Availability | SUNWcsu | + |_____________________________|_____________________________| + | CSI | Enabled | + |_____________________________|_____________________________| + | Interface Stability | Commited | + |_____________________________|_____________________________| + + +SEE ALSO + cat(1), tail(1) # Manpage diff for shcomp --- /dev/null Wed Feb 13 05:14:51 2008 +++ shcomp.1.new.txt Fri Nov 30 00:43:23 2007 @@ -1,0 +1,66 @@ +NAME + shcomp - compile a ksh93 shell script + +SYNOPSIS + shcomp [-nv] [infile [outfile]] + + shcomp -D [infile [outfile]] + +DESCRIPTION + Unless -D is specified, shcomp takes a shell script, infile, + and creates a binary format file, outfile, that ksh93 can read + and execute with the same effect as the original script. + + Since aliases are processed as the script is read, alias + definitions whose value requires variable expansion will not + work correctly. + + If -D is specifed, all double quoted strings that are preceded + by $ are printed, one literal per line, e.g. a literal $"foo" + will be printed as "foo" in the output + These are the messages that need to be translated to locale + specific versions for internationalization. + + If outfile is omitted, both modes will write their results + to standard output. If infile is also omitted, the + shell script will be read from standard input. + +OPTIONS + -D, --dictionary + Generate a list of strings that need to be + placed in a message catalog for + internationalization. + -n, --noexec Displays warning messages for obsolete or + non-conforming constructs. + -v, --verbose Displays input from infile onto standard error + as it reads it. + +EXIT STATUS + 0 Successful completion. + >0 An error occurred. + +ATTRIBUTES + See attributes(5) for descriptions of the following attri- + butes: + + /usr/bin/shcomp + ____________________________________________________________ + | ATTRIBUTE TYPE | ATTRIBUTE VALUE | + |_____________________________|_____________________________| + | Availability | SUNWcsu | + |_____________________________|_____________________________| + | CSI | Enabled | + |_____________________________|_____________________________| + | Interface Stability | See below | + |_____________________________|_____________________________| + + + The stability of the /usr/bin/shcomp command-line interface + and thesystem variables documented in shcomp(1) is "Committed"; + the compiled shell code format is "Committed Private" ("shcomp" + being the only generator of the format and /usr/bin/ksh93 the + only consumer; both share the same code via libshell) and + the output of the "-D" option is "Volatile". + +SEE ALSO + ksh93(1) # Manpage diff for sleep --- sleep.1.original.txt Thu Nov 22 17:21:44 2007 +++ sleep.1.new.txt Fri Nov 23 20:20:45 2007 @@ -9,7 +9,7 @@ sleep - suspend execution for an interval SYNOPSIS - /usr/bin/sleep _t_i_m_e + /usr/bin/sleep _seconds_ ksh93 sleep _seconds_ @@ -16,11 +16,6 @@ DESCRIPTION - /usr/bin/sleep - The sleep utility will suspend execution for at least the - integral number of seconds specified by the _t_i_m_e operand. - - ksh93 sleep suspends execution for at least the time specified by seconds or until a SIGALRM signal is received. seconds can be specifed as a floating point number but the actual granularity depends on the underlying system, normally @@ -28,10 +23,14 @@ OPERANDS - The following operands are supported for /usr/bin/sleep: + The following operands are supported for /usr/bin/sleep and ksh93's + "sleep" built-in command: - _t_i_m_e A non-negative decimal integer specifying the + _t_i_m_e A non-negative floating-point number specifying the number of seconds for which to suspend execution. + The floating-point number may be specified in all formats + required by C99/XPG6, including constants such as "Inf" or + "infinite". @@ -50,6 +49,20 @@ sleep 37 done + Example 2: Suspending command execution forever (or until a SIGALRM + signal is received): + + example% sleep Inf + + + Example 3: Suspending command execution for 0.5 seconds using + an alternative floating-point representation for the value "0.5": + + example% printf "%a\n" 0.5 + 0x1.0000000000000000000000000000p-01 + + example% sleep 0x1.0000000000000000000000000000p-01 + ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of sleep: LANG, LC_ALL, @@ -121,9 +134,10 @@ The sleep utility will take the standard action for all other signals. + The behaviour for input values such as "NaN" (not-a-number) or negative + values is undefined. - # Manpage diff for sum --- sum.1.original.txt Fri Oct 19 03:49:51 2007 +++ sum.1.new.txt Fri Feb 15 07:27:37 2008 @@ -9,22 +9,186 @@ sum - print checksum and block count for a file SYNOPSIS - sum [-r] [file...] + /usr/bin/sum [-abBchHlLpPrRstTw] [-x method] [file...] + ksh93 + sum [-abBchHlLpPrRstTw] [-x method] [file...] + DESCRIPTION - The sum utility calculates and prints a 16-bit checksum for - the named file and the number of 512-byte blocks in the - file. It is typically used to look for bad spots, or to - validate a file communicated over some transmission line. + /usr/bin/sum + ksh93 "sum" + The sum command and ksh93 built-in command "sum" lists the + checksum, and for most methods the block count, for each file + argument. The standard input is read if there are no file + arguments. + getconf UNIVERSE determines the default + sum method: att for the att universe, bsd otherwise. The + default for the other commands is the command name itself. The + att method is a true sum, all others are order dependent. -OPTIONS - The following options are supported: + Method names consist of a leading identifier and 0 or more + options separated by -. - -r Use an alternate (machine-dependent) algorithm in - computing the checksum. + getconf PATH_RESOLVE determines how symbolic links are + handled. This can be explicitly overridden by the --logical, + --metaphysical, and --physical options below. PATH_RESOLVE can + be one of: + logical + Follow all symbolic links. + metaphysical + Follow command argument symbolic links, otherwise + don't follow. + physical + Don't follow symbolic links. +OPTIONS + The following options are supported by /usr/bin/sum + -a, --all List the checksum for all files. Use with + --total to list both individual and total + checksums and block counts. + -b, --binary Read files in binary mode. This is the + default. + -B, --scale=scale + Block count scale (bytes per block) override + for methods that include size in the output. + The default is method specific. + -c, --check Each file is interpreted as the output from a + previous sum. If --header or --permissions was + specified in the previous sum then the + checksum method is automatically determined, + otherwise --method must be specified. The + listed checksum is compared with the current + value and a warning is issued for each file + that does not match. If file was generated by + --permissions then the file mode, user and + group are also checked. Empty lines, lines + starting with #<space>, or the line # are + ignored. Lines containing no blanks are + interpreted as [no]name[=value] options: + method=name + Checksum method to apply to subsequent + lines. + permissions + Subsequent lines were generated with + --permissions. + -h, --header Print the checksum method as the first output + line. Used with --check and --permissions. + -l, --list Each file is interpreted as a list of files, + one per line, that is checksummed. + -p, --permissions + If --check is not specified then list the file + mode, user and group between the checksum and + path. User and group matching the caller are + output as -. If --check is specified then the + mode, user and group for each path in file are + updated if necessary to match those in file. A + warning is printed on the standard error for + each changed file. + -R, --recursive Recursively checksum the contents of + directories. + -t, --total List only the total checksum and block count + of all files. --all --total lists each + checksum and the total. The total checksum and + block count may be different from the checksum + and block count of the catenation of all files + due to partial blocks that may occur when the + files are treated separately. + -T, --text Read files in text mode (i.e., treat \r\n as + \n). + -w, --warn Warn about invalid --check lines. On by + default; -w means --nowarn. + -x, --method|algorithm=method + Specifies the checksum method to apply. Parenthesized method options are readonly implementation + details. + att|sys5|s5|default + The system 5 release 4 checksum. This is the default for sum when getconf UNIVERSE is att. + This is the only true sum; all of the other methods are order dependent. + ast4|32x4|tw + The ast 128 bit PRNG hash generated by catenating 4 separate 32 bit PNRG hashes. The block + count is not printed. + bsd|ucb + The BSD checksum. + crc 32 bit CRC (cyclic redundancy check). + polynomial=mask + The 32 bit crc polynomial bitmask with implicit bit 32. The default value is + 0xedb88320. + done[=number] + XOR the final crc value with number. 0xffffffff is used if number is omitted. The + option value may be omitted. The default value is 0. + init[=number] + The initial crc value. 0xffffffff is used if number is omitted. The option value may + be omitted. The default value is 0. + rotate + XOR each input character with the high order crc byte (instead of the low order). + size[=number] + Include the total number of bytes in the crc. number, if specified, is first XOR'd + into the size. The option value may be omitted. The default value is 0. + prng 32 bit PRNG (pseudo random number generator) hash. + mpy=number + The 32 bit PRNG multiplier. The default value is 0x01000193. + add=number + The 32 bit PRNG addend. The default value is 0. + init[=number] + The PRNG initial value. 0xffffffff is used if number is omitted. The option value may + be omitted. The default value is 0x811c9dc5. + md4|MD4 + RFC1320 MD4 message digest. Cryptographically weak. The block count is not printed. + (version) + md4 (solaris -lmd) 2005-07-26 + md5|MD5 + RFC1321 MD5 message digest. Cryptographically weak. The block count is not printed. + (version) + md5 (solaris -lmd) 2005-07-26 + sha1|SHA1|sha-1|SHA-1 + RFC3174 / FIPS 180-1 SHA-1 secure hash algorithm 1. Cryptographically weak. The block count + is not printed. + (version) + sha1 (solaris -lmd) 2005-07-26 + sha256|sha-256|SHA256|SHA-256 + FIPS 180-2 SHA256 secure hash algorithm. The block count is not printed. + (version) + sha256 (solaris -lmd) 2005-07-26 + sha384|sha-384|SHA384|SHA-384 + FIPS 180-2 SHA384 secure hash algorithm. The block count is not printed. + (version) + sha384 (solaris -lmd) 2005-07-26 + sha512|sha-512|SHA512|SHA-512 + FIPS 180-2 SHA512 secure hash algorithm. The block count is not printed. + (version) + sha512 (solaris -lmd) 2005-07-26 + posix|cksum|std|standard + The posix 1003.2-1992 32 bit crc checksum. This is the default cksum(1) method. Shorthand for + crc-0x04c11db7-rotate-done-size. + zip The zip(1) crc. Shorthand for crc-0xedb88320-init-done. + fddi The FDDI crc. Shorthand for crc-0xedb88320-size=0xcc55cc55. + fnv|fnv1 + The Fowler-Noll-Vo 32 bit PRNG hash with non-zero initializer (FNV-1). Shorthand for + prng-0x01000193-init=0x811c9dc5. + ast|strsum + The ast strsum(3) PRNG hash. Shorthand for prng-0x63c63cd9-add=0x9c39c33d. + -L, --logical|follow + Follow symbolic links when traversing + directories. The default is determined by + getconf PATH_RESOLVE. + -H, --metaphysical + Follow command argument symbolic links, + otherwise don't follow symbolic links when + traversing directories. The default is + determined by getconf PATH_RESOLVE. + -P, --physical Don't follow symbolic links when traversing + directories. The default is determined by + getconf PATH_RESOLVE. + -r, --bsd Equivalent to --method=bsd --scale=512 for + compatibility with other sum(1) + implementations. + -s, --sysv Equivalent ti --method=sys5 for for + compatibility with other sum(1) + implementations. + -S, --silent|status + No output for --check; 0 exit status means all + sums matched, non-0 means at least one sum + failed to match. Ignored for --permissions. - OPERANDS The following operands are supported: @@ -32,7 +196,6 @@ standard input is used. - USAGE See largefile(5) for the description of the behavior of sum when encountering files greater than or equal to 2 Gbyte ( 2 @@ -73,14 +236,16 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | + |_____________________________|_____________________________| | Availability | SUNWesu | + |_____________________________|_____________________________| | CSI | enabled | |_____________________________|_____________________________| SEE ALSO - cksum(1), sum(1B), wc(1), attributes(5), environ(5), large- - file(5) + cksum(1), ksh93(1), sum(1B), wc(1), libmd(3lib), attributes(5), + environ(5), largefile(5) DIAGNOSTICS "Read error" is indistinguishable from end of file on most @@ -87,7 +252,9 @@ devices; check the block count. NOTES - Portable applications should use cksum(1). + Portable applications should use cksum(1), the default algorithm + for this command is defined in the POSIX standard and identical + across platforms. sum and usr/ucb/sum (see sum(1B)) return different check- sums. # Manpage diff for test --- test.1.original.txt Thu Nov 22 15:28:36 2007 +++ test.1.new.txt Fri Nov 23 20:19:14 2007 @@ -323,9 +323,11 @@ - _n_1 -eq _n_2 True if the integers _n_1 and _n_2 are + _n_1 -eq _n_2 True if the numbers _n_1 and _n_2 are algebraically equal. - (ksh93 also supports floating point numbers.) + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. @@ -341,34 +343,43 @@ - _n_1 -ne _n_2 True if the integers _n_1 and _n_2 are + _n_1 -ne _n_2 True if the numbers _n_1 and _n_2 are not algebraically equal. - (ksh93 also supports floating point numbers.) + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. - _n_1 -gt _n_2 True if the integer _n_1 is algebrai- - cally greater than the integer _n_2. - (ksh93 also supports floating point numbers.) + _n_1 -gt _n_2 True if the number _n_1 is algebrai- + cally greater than the number _n_2. + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. - _n_1 -ge _n_2 True if the integer _n_1 is algebrai- + _n_1 -ge _n_2 True if the number _n_1 is algebrai- cally greater than or equal to the - integer _n_2. - (ksh93 also supports floating point numbers.) + number _n_2. + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. + _n_1 -lt _n_2 True if the number _n_1 is algebrai- + cally less than the number _n_2. + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. - _n_1 -lt _n_2 True if the integer _n_1 is algebrai- - cally less than the integer _n_2. - (ksh93 also supports floating point numbers.) - - _n_1 -le _n_2 True if the integer _n_1 is algebrai- + _n_1 -le _n_2 True if the number _n_1 is algebrai- cally less than or equal to the - integer _n_2. - (ksh93 also supports floating point numbers.) + number _n_2. + A "number" may be integer, floating point or floating-point + constant (such as [+/-]Inf, [+/-]NaN) in any format specified + by C99/XPG6/SUS. @@ -714,8 +725,8 @@ endif - ksh - Example 5: Using the ksh built-in + ksh/ksh93 + Example 5: Using the ksh/ksh93 built-in ZERO=0 ONE=1 TWO=$((ONE+ONE)) ROOT=root if ((ONE > ZERO)) # _a_r_i_t_h_m_e_t_i_c_a_l _c_o_m_p_a_r_i_s_o_n @@ -822,13 +833,22 @@ sition aid for BSD applications and may not be supported in future releases. - When comparing file timestamps, the ksh93 test built-in - handles high-resolution timestamps of up to nanosecond - granularity, for filesystems which support them. + When comparing file timestamps, the /usr/bin/test and the + ksh93 test built-in handle high-resolution timestamps of up + to nanosecond granularity, for filesystems which support them. + XPG4/sh, ksh, ksh93: Is is recommended to use arithmetric + expressions (e.g. $(( x > 3.1 )) # instead of + $ /usr/bin/test "$x" -gt 3.1 # ) when comparing two floating-point + variables or a constant and a floating-point variable to prevent + rounding errors (caused by the base16 to base10 transformation) to + affect the result. Additionally the built-in arithmetric support + in XPG4/sh, ksh and ksh93 is significantly faster because it + doesn't require the explicit transformation to strings for each + comparisation. + - # Manpage diff for tty --- tty.1.original.txt Fri Oct 19 08:25:13 2007 +++ tty.1.new.txt Fri Nov 23 20:20:14 2007 @@ -9,15 +9,28 @@ tty - return user's terminal name SYNOPSIS - tty [-l] [-s] + /usr/bin/tty [-l] [-s] + ksh93 + tty [ options ] + DESCRIPTION + /usr/bin/tty + The tty utility writes to the standard output the name of the terminal that is open as standard input. The name that is used is equivalent to the string that would be returned by the ttyname(3C) function. + ksh93 + + The ksh93 tty built-in writes the name of the terminal that + is connected to standard input onto standard output. If the + standard input is not a terminal, "not a tty" will be written + to standard output. + OPTIONS + /usr/bin/tty The following options are supported: -l Prints the synchronous line number to which the @@ -29,8 +42,16 @@ -s Inhibits printing of the terminal path name, allow- ing one to test just the exit status. + ksh93 + -l, --line-number + Write the synchronous line number of the terminal + on a separate line following the terminal name line. + If the standard input is not a synchronous terminal + then "not on an active synchronous line" is written. + -s, --silent|quiet + Disable the terminal name line. + Portable applications should use [[ -t 0 ]] instead. - ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of tty: LANG, LC_ALL, --- typeset.1.txt Fri May 23 23:03:15 2008 +++ typeset.1.txt Fri May 23 23:03:15 2008 @@ -45,7 +45,9 @@ expansion occurs on value. OPTIONS -a[type] Indexed array. This is the default. If [type] is specified, each subscript is interpreted as a value of type type. The option value may be omitted. -b Each name may contain binary data. Its value is the mime base64 encoding of the data. It can be used with -Z, to specify fixed sized fields. + -C Reserved for future usage. @@ -92,6 +94,18 @@ If the -Z attribute is also specified, then zeros will be used as the fill character. Otherwise, spaces are used. The option value may be omitted. + -X[n] Floating point number represented in hexadecimal notation. n + specifies the number of significant figures when the value is + expanded. The option value may be omitted. The default value + is 10. + -h Reserved for future usage. + -S When used inside a + function defined with the function reserved word, the + specified variables will have function static scope. + -T Reserved for future usage. -Z[n] Zero fill. If n is given it represents the field width. The option value may be omitted. --- ksh93.1.txt Thu Jun 12 00:13:19 2008 +++ ksh93.1.txt Thu Jun 12 00:15:00 2008 @@ -3252,6 +3252,11 @@ 516972-0. CAVEATS + It is recommended that ksh93 scripts should choose shell + function names outside the namespace used by reserved + keywords of the ISO C99, C++ and JAVA languages to avoid + collisions with future enhancements to ksh93. + If a command is executed, and then a command with the same name is installed in a directory in the search path before the directory where the original command was found, the -------------- next part -------------- --- cksum.1.old.txt Tue Apr 21 01:43:08 2009 +++ cksum.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,22 +9,30 @@ cksum - write file checksums and sizes SYNOPSIS - cksum [file...] + /usr/bin/cksum + /usr/bin/cksum [ options ] [file...] + + ksh93 + cksum [ options ] [file...] DESCRIPTION - The cksum command calculates and writes to standard output a - cyclic redundancy check (CRC) for each input file, and also - writes to standard output the number of octets in each file. + The cksum command and ksh93 built-in command "cksum" lists + the checksum, and for most methods the block count, for each + file argument. The standard input is read if there are no + file arguments. - For each file processed successfully, cksum will write in - the following format: + The default method is "cksum" which calculates and writes + to standard output a cyclic redundancy check (CRC) for each + input file, and also writes to standard output the number + of octets in each file. + For each file processed successfully the cksum method will + write in the following format: + "%u %d %s\n" <checksum>, <# of octets>, <path name> + Method names consist of a leading identifier and 0 or more + options separated by -. - - If no file operand was specified, the path name and its - leading space will be omitted. - The CRC used is based on the polynomial used for CRC error checking in the referenced Ethernet standard. @@ -36,7 +44,6 @@ Mathematically, the CRC value corresponding to a given file is defined by the following procedure: - 1. The n bits to be evaluated are considered to be the coefficients of a mod 2 polynomial M(x) of degree n-1. These n bits are the bits from the file, with the most @@ -49,32 +56,183 @@ first. The smallest number of octets capable of representing this integer is used. - 2. M(x) is multiplied by x**32 (that is, shifted left 32 bits) and divided by G(x) using mod 2 division, produc- ing a remainder R(x) of degree < 31. - 3. The coefficients of R(x) are considered to be a 32-bit sequence. + 4. The bit sequence is complemented and the result is the + CRC. -SunOS 5.10 Last change: 1 Feb 1995 1 + getconf PATH_RESOLVE determines how symbolic links are + handled. This can be explicitly overridden by the --logical, + --metaphysical, and --physical options below. PATH_RESOLVE + can be one of: + logical + Follow all symbolic links. + metaphysical + Follow command argument symbolic links, otherwise + don't follow. + physical + Don't follow symbolic links. +OPTIONS + The following options are supported by /usr/bin/cksum + -a, --all List the checksum for all files. Use with + --total to list both individual and total + checksums and block counts. + -b, --binary Read files in binary mode. This is the + default. + -B, --scale=scale + Block count scale (bytes per block) override + for methods that include size in the output. + The default is method specific. + -c, --check Each file is interpreted as the output from a + previous sum. If --header or --permissions was + specified in the previous sum then the + checksum method is automatically determined, + otherwise --method must be specified. The + listed checksum is compared with the current + value and a warning is issued for each file + that does not match. If file was generated by + --permissions then the file mode, user and + group are also checked. Empty lines, lines + starting with #<space>, or the line # are + ignored. Lines containing no blanks are + interpreted as [no]name[=value] options: + method=name + Checksum method to apply to subsequent + lines. + permissions + Subsequent lines were generated with + --permissions. + -h, --header Print the checksum method as the first output + line. Used with --check and --permissions. + -l, --list Each file is interpreted as a list of files, + one per line, that is checksummed. + -p, --permissions + If --check is not specified then list the file + mode, user and group between the checksum and + path. User and group matching the caller are + output as -. If --check is specified then the + mode, user and group for each path in file are + updated if necessary to match those in file. A + warning is printed on the standard error for + each changed file. + -R, --recursive Recursively checksum the contents of + directories. + -t, --total List only the total checksum and block count + of all files. --all --total lists each + checksum and the total. The total checksum and + block count may be different from the checksum + and block count of the catenation of all files + due to partial blocks that may occur when the + files are treated separately. + -T, --text Read files in text mode (i.e., treat \r\n as + \n). + -w, --warn Warn about invalid --check lines. On by + default; -w means --nowarn. + -x, --method|algorithm=method + Specifies the checksum method to apply. Parenthesized method options are readonly implementation + details. + att|sys5|s5|default + The system 5 release 4 checksum. This is the default for sum when getconf UNIVERSE is att. + This is the only true sum; all of the other methods are order dependent. + ast4|32x4|tw + The ast 128 bit PRNG hash generated by catenating 4 separate 32 bit PNRG hashes. The block + count is not printed. + bsd|ucb + The BSD checksum. + crc 32 bit CRC (cyclic redundancy check). + polynomial=mask + The 32 bit crc polynomial bitmask with implicit bit 32. The default value is + 0xedb88320. + done[=number] + XOR the final crc value with number. 0xffffffff is used if number is omitted. The + option value may be omitted. The default value is 0. + init[=number] + The initial crc value. 0xffffffff is used if number is omitted. The option value may + be omitted. The default value is 0. + rotate + XOR each input character with the high order crc byte (instead of the low order). + size[=number] + Include the total number of bytes in the crc. number, if specified, is first XOR'd + into the size. The option value may be omitted. The default value is 0. + prng 32 bit PRNG (pseudo random number generator) hash. + mpy=number + The 32 bit PRNG multiplier. The default value is 0x01000193. + add=number + The 32 bit PRNG addend. The default value is 0. + init[=number] + The PRNG initial value. 0xffffffff is used if number is omitted. The option value may + be omitted. The default value is 0x811c9dc5. + md4|MD4 + RFC1320 MD4 message digest. Cryptographically weak. The block count is not printed. + (version) + md4 (solaris -lmd) 2005-07-26 + md5|MD5 + RFC1321 MD5 message digest. Cryptographically weak. The block count is not printed. + (version) + md5 (solaris -lmd) 2005-07-26 + sha1|SHA1|sha-1|SHA-1 + RFC3174 / FIPS 180-1 SHA-1 secure hash algorithm 1. Cryptographically weak. The block count + is not printed. + (version) + sha1 (solaris -lmd) 2005-07-26 + sha256|sha-256|SHA256|SHA-256 + FIPS 180-2 SHA256 secure hash algorithm. The block count is not printed. + (version) + sha256 (solaris -lmd) 2005-07-26 + sha384|sha-384|SHA384|SHA-384 + FIPS 180-2 SHA384 secure hash algorithm. The block count is not printed. + (version) + sha384 (solaris -lmd) 2005-07-26 + sha512|sha-512|SHA512|SHA-512 + FIPS 180-2 SHA512 secure hash algorithm. The block count is not printed. + (version) + sha512 (solaris -lmd) 2005-07-26 + posix|cksum|std|standard + The posix 1003.2-1992 32 bit crc checksum. This is the default cksum(1) method. Shorthand for + crc-0x04c11db7-rotate-done-size. + zip The zip(1) crc. Shorthand for crc-0xedb88320-init-done. + fddi The FDDI crc. Shorthand for crc-0xedb88320-size=0xcc55cc55. + fnv|fnv1 + The Fowler-Noll-Vo 32 bit PRNG hash with non-zero initializer (FNV-1). Shorthand for + prng-0x01000193-init=0x811c9dc5. + ast|strsum + The ast strsum(3) PRNG hash. Shorthand for prng-0x63c63cd9-add=0x9c39c33d. + -L, --logical|follow + Follow symbolic links when traversing + directories. The default is determined by + getconf PATH_RESOLVE. + -H, --metaphysical + Follow command argument symbolic links, + otherwise don't follow symbolic links when + traversing directories. The default is + determined by getconf PATH_RESOLVE. + -P, --physical Don't follow symbolic links when traversing + directories. The default is determined by + getconf PATH_RESOLVE. + -r, --bsd Equivalent to --method=bsd --scale=512 for + compatibility with other sum(1) + implementations. + -s, --sysv Equivalent ti --method=sys5 for for + compatibility with other sum(1) + implementations. + -S, --silent|status + No output for --check; 0 exit status means all + sums matched, non-0 means at least one sum + failed to match. Ignored for --permissions. + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information - - - -User Commands cksum(1) - - - - 4. The bit sequence is complemented and the result is the - CRC. - - OPERANDS The following operand is supported: @@ -87,11 +245,12 @@ The cksum command is typically used to quickly compare a suspect file against a trusted version of the same, such as to ensure that files transmitted over noisy media arrive - intact. However, this comparison cannot be considered cryp- - tographically secure. The chances of a damaged file produc- - ing the same CRC as the original are astronomically small; - deliberate deception is difficult, but probably not impossi- - ble. + intact. However, the CRC comparison cannot be considered + cryptographically secure. The chances of a damaged file + producing the same CRC as the original are astronomically + small; deliberate deception is difficult, but probably not + impossible. In such cases a cryptographically stronger hash + method (such as "sha512") is recommended. Although input files to cksum can be any type, the results need not be what would be expected on character special dev- @@ -99,13 +258,14 @@ size used when doing input, checksums of character special files need not process all of the data in those files. - The algorithm is expressed in terms of a bitstream divided - into octets. If a file is transmitted between two systems - and undergoes any data transformation (such as moving 8-bit - characters into 9-bit bytes or changing "Little Endian" byte - ordering to "Big Endian"), identical CRC values cannot be - expected. Implementations performing such transformations - may extend cksum to handle such situations. + The CRC algorithm is expressed in terms of a bitstream + divided into octets. If a file is transmitted between two + systems and undergoes any data transformation (such as + moving 8-bit characters into 9-bit bytes or changing + "Little Endian" byte ordering to "Big Endian"), identical + CRC values cannot be expected. Implementations + performing such transformations may extend cksum to handle + such situations. See largefile(5) for the description of the behavior of cksum when encountering files greater than or equal to 2 @@ -121,22 +281,6 @@ 0 All files were processed successfully. - - - - - -SunOS 5.10 Last change: 1 Feb 1995 2 - - - - - - -User Commands cksum(1) - - - >0 An error occurred. @@ -153,46 +297,12 @@ | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. SEE ALSO - digest(1), sum(1), bart(1M), attributes(5), environ(5), lar- - gefile(5), standards(5) + digest(1), ksh93(1), sum(1), bart(1M), attributes(5), + environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/cksum.html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 1 Feb 1995 3 - - - --- head.1.old.txt Tue Apr 21 01:43:08 2009 +++ head.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,42 +9,53 @@ head - display first few lines of files SYNOPSIS - head [-number | -n number] [filename...] + /usr/bin/head + /usr/bin/head [ options ] [file...] + + ksh93 + head [ options ] [file...] DESCRIPTION - The head utility copies the first number of lines of each - filename to the standard output. If no filename is given, - head copies lines from the standard input. The default value - of number is 10 lines. + head copies one or more input files to standard output + stopping at a designated point for each file or to the end of + the file whichever comes first. Copying ends at the point + indicated by the options. By default a header of the form ==> + filename <== is output before all but the first file but this + can be changed with the -q and -v options. - When more than one file is specified, the start of each file - will look like: + If no file is given, or if the file is -, head copies from + standard input starting at the current location. - ==> filename <== + The option argument for -c, and -s can optionally be followed + by one of the following characters to specify a different + unit other than a single byte: + b 512 bytes. + k 1-killobyte. + m 1-megabyte. + For backwards compatibility, -number is equivalent to -n + number. - Thus, a common way to display a set of short files, identi- - fying each one, is: - - example% head -9999 filename1 filename2 ... - OPTIONS The following options are supported: - -n number The first number lines of each input file - will be copied to standard output. The - number option-argument must be a positive - decimal integer. + -n, --lines=lines + Copy lines lines from each file. The default + value is 10. + -c, --bytes=chars + Copy chars bytes from each file. + -q, --quiet|silent + Never ouput filename headers. + -s, --skip=skip Skip skip characters or lines from each file + before copying. + -v, --verbose Always ouput filename headers. + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information - - - -number The number argument is a positive decimal - integer with the same effect as the -n - number option. - - - - If no options are specified, head will act as if -n 10had + If no options are specified, head will act as if -n 10 had been specified. OPERANDS @@ -54,23 +65,6 @@ operands are specified, the standard input will be used. - - - - - - -SunOS 5.10 Last change: 1 Feb 1995 1 - - - - - - -User Commands head(1) - - - USAGE See largefile(5) for the description of the behavior of head when encountering files greater than or equal to 2 Gbyte ( 2 @@ -114,18 +108,14 @@ | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. SEE ALSO - cat(1), more(1), pg(1), tail(1), attributes(5), environ(5), - largefile(5), standards(5) + cat(1), ksh93(1), more(1), pg(1), tail(1), tee(1), + attributes(5), environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/head.html - - - - - - SunOS 5.10 Last change: 1 Feb 1995 2 --- join.1.old.txt Tue Apr 21 01:43:08 2009 +++ join.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,33 +9,37 @@ join - relational database operator SYNOPSIS - join [-a filenumber | -v filenumber] [-1 fieldnumber] - [-2 fieldnumber] [-o list] [-e string] [-t char] file1 file2 + /usr/bin/join + /usr/bin/join [ options ] file1 file2 - join [-a filenumber] [-j fieldnumber] [-j1 fieldnumber] - [-j2 fieldnumber] [-o list] [-e string] [-t char] file1 - file2 + + ksh93 + join [ options ] file1 file2 + DESCRIPTION - The join command forms, on the standard output, a join of - the two relations specified by the lines of file1 and file2. + join performs an equality join on the files file1 and file2 + and writes the resulting joined files to standard output. By + default, a field is delimited by one or more spaces and tabs + with leading spaces and/or tabs ignored. The -t option can be + used to change the field delimiter. - There is one line in the output for each pair of lines in - file1 and file2 that have identical join fields. The output - line normally consists of the common field, then the rest of - the line from file1, then the rest of the line from file2. - This format can be changed by using the -o option (see - below). The -a option can be used to add unmatched lines to - the output. The -v option can be used to output only + The join field is a field in each file on which files are + compared. By default join writes one line in the output for + each pair of lines in files1 and files2 that have identical + join fields. The default output line consists of the join + field, then the remaining fields from file1, then the + remaining fields from file2, but this can be changed with the + -o option. The -a option can be used to add unmatched lines + to the output. The -v option can be used to output only unmatched lines. - The default input field separators are blank, tab, or new- - line. In this case, multiple separators count as one field - separator, and leading separators are ignored. The default - output field separator is a blank. + The files file1 and file2 must be ordered in the collating + sequence of sort -b on the fields on which they are to be + joined otherwise the results are unspecified. - If the input files are not in the appropriate collating - sequence, the results are unspecified. + If either file1 or file2 is -, join uses standard input + starting at the current location. OPTIONS Some of the options below use the argument filenumber. This @@ -42,107 +46,55 @@ argument should be a 1 or a 2 referring to either file1 or file2, respectively. - -a filenumber In addition to the normal output, - produce a line for each unpairable - line in file filenumber, where - filenumber is 1 or 2. If both -a 1 - and -a 2 are specified, all unpair- - able lines will be output. + -e, --empty=string + Replace empty output fields in the list + selected with -o with string. + -o, --output=list + Construct the output line to comprise the + fields specified in a blank or comma + separated list list. Each element in list + consists of a file number (either 1 or 2), a + period, and a field number or 0 representing + the join field. As an obsolete feature + multiple occurrences of -o can be specified. + -t, --separator|tabs=delim + Use delim as the field separator for both + input and output. + -1, --j1=field Join on field field of file1. Fields start at + 1. + -2, --j2=field Join on field field of file2. Fields start at + 1. + -j, --join=field + Equivalent to -1 field -2 field. + -a, --unpairable=fileno + Write a line for each unpairable line in file + fileno, where fileno is either 1 or 2, in + addition to the normal output. If -a options + appear for both 1 and 2, then all unpairable + lines will be output. + -v, --suppress=fileno + Write a line for each unpairable line in file + fileno, where fileno is either 1 or 2, + instead of the normal output. If -v options + appear for both 1 and 2, then all unpairable + lines will be output. + -i, --ignorecase + Ignore case in field comparisons. + -B, --mmap Enable memory mapped reads instead of + buffered. On by default; -B means --nommap. + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information + The following option forms are also recognized: -j + field is equivalent to -1 field -2 field, -j1 field is + equivalent to -1 field, and -j2 field is equivalent to -2 + field. - -e string Replace empty output fields in the - list selected by option -o with the - string string. - - - - - -SunOS 5.10 Last change: 8 Feb 2000 1 - - - - - - -User Commands join(1) - - - - -j fieldnumber Equivalent to -1fieldnumber -2field- - number. - - - - -j1 fieldnumber Equivalent to -1fieldnumber. - - - - -j2 fieldnumber Equivalent to -2fieldnumber. Fields - are numbered starting with 1. - - - - -o list Each output line includes the fields - specified in list. Fields selected - by list that do not appear in the - input will be treated as empty out- - put fields. (See the -e option.) - Each element of which has the either - the form filenumber.fieldnumber, or - 0, which represents the join field. - The common field is not printed - unless specifically requested. - - - - -t char Use character char as a separator. - Every appearance of char in a line - is significant. The character char - is used as the field separator for - both input and output. With this - option specified, the collating term - should be the same as sort without - the -b option. - - - - -v filenumber Instead of the default output, pro- - duce a line only for each unpairable - line in filenumber, where filenumber - is 1 or 2. If both -v 1 and -v 2 are - specified, all unpairable lines will - be output. - - - - -1 fieldnumber Join on the fieldnumberth field of - file 1. Fields are decimal integers - starting with 1. - - - - - -SunOS 5.10 Last change: 8 Feb 2000 2 - - - - - - -User Commands join(1) - - - - -2fieldnumber Join on the fieldnumberth field of - file 2. Fields are decimal integers - starting with 1. - - - OPERANDS The following operands are supported: @@ -188,21 +140,6 @@ and file fax: - - - - -SunOS 5.10 Last change: 8 Feb 2000 3 - - - - - - -User Commands join(1) - - - !Name Fax Number Don +1 123-456-7899 @@ -254,24 +191,12 @@ | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. - - - -SunOS 5.10 Last change: 8 Feb 2000 4 - - - - - - -User Commands join(1) - - - SEE ALSO - awk(1), comm(1), sort(1), uniq(1), attributes(5), - environ(5), largefile(5), standards(5) + awk(1), comm(1), ksh93(1), paste(1), sort(1), uniq(1), + attributes(5), environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/join.html NOTES With default field separation, the collating sequence is @@ -282,49 +207,5 @@ mands are wildly incongruous. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 8 Feb 2000 5 - - --- logname.1.old.txt Tue Apr 21 01:43:08 2009 +++ logname.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,16 +9,28 @@ logname - return user's login name SYNOPSIS - logname + /usr/bin/logname + /usr/bin/logname [ options ] + + ksh93 + logname [ options ] DESCRIPTION - The logname utility will write the user's login name to - standard output. The login name is the string that would be - returned by the getlogin(3C) function. Under the conditions - where getlogin() would fail, logname will write a diagnostic - message to standard error and exit with a non-zero exit - status. + logname writes the users's login name to standard output. The + login name is the string that is returned by the getlogin(2) + function. If getlogin(2) does not return successfully, the + corresponding to the real user id of the calling process is + used instead. +OPTIONS + The following option is supported: + + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information + ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment variables that affect the execution of logname: LANG, @@ -51,82 +63,19 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| - | Availability | SUNWesu | + | Availability | SUNWcsu | |_____________________________|_____________________________| | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. - - - -SunOS 5.10 Last change: 3 Nov 2000 1 - - - - - - -User Commands logname(1) - - - SEE ALSO - env(1), login(1), getlogin(3C), utmpx(4), attributes(5), - environ(5), standards(5) + env(1), ksh93(1), login(1), getlogin(3C), utmpx(4), + attributes(5), environ(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/logname.html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 3 Nov 2000 2 - - - --- mkfifo.1m.old.txt Tue Apr 21 01:43:08 2009 +++ mkfifo.1m.new.txt Tue Apr 21 01:43:08 2009 @@ -6,10 +6,14 @@ NAME - mkfifo - make FIFO special file + mkfifo - make FIFO special files (named pipes) SYNOPSIS - /usr/bin/mkfifo [-m mode] path... + /usr/bin/mkfifo + /usr/bin/mkfifo [ options ] [file...] + + ksh93 + mkfifo [ options ] [file...] DESCRIPTION The mkfifo utility creates the FIFO special files named by @@ -31,15 +35,16 @@ OPTIONS The following option is supported: - -m mode Sets the file permission bits of the newly-created - FIFO to the specified mode value. The mode option- - argument will be the same as the mode operand - defined for the chmod(1) command. In <symbolicmode> - strings, the op characters + and - will be inter- - preted relative to an assumed initial mode of a=rw. + -m, --mode=mode Set the mode of created FIFO to mode. mode is + symbolic or octal mode as in chmod(1). + Relative modes assume an initial mode of + a=rw. + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information - - OPERANDS The following operand is supported: @@ -58,19 +63,6 @@ LC_CTYPE, LC_MESSAGES, and NLSPATH. - - -SunOS 5.10 Last change: 16 Sep 1996 1 - - - - - - -System Administration Commands mkfifo(1M) - - - EXIT STATUS The following exit values are returned: @@ -90,43 +82,18 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| - | Availability | SUNWesu | + | Availability | SUNWcsu | |_____________________________|_____________________________| | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. SEE ALSO - mkfifo(3C), attributes(5), environ(5), largefile(5), stan- - dards(5) + chmod(1), ksh93(1), umask(1), mknod(1m), mkfifo(3C), + attributes(5), environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/mkfifo.html - - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 16 Sep 1996 2 - - - --- tail.1.old.txt Tue Apr 21 01:43:08 2009 +++ tail.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,36 +9,45 @@ tail - deliver the last part of a file SYNOPSIS - /usr/bin/tail [ _s number [lbcr]] [file] + /usr/bin/tail + /usr/bin/tail [ options ] [file...] - /usr/bin/tail [-lbcr] [file] + /usr/xpg4/bin/tail + /usr/xpg4/bin/tail [ options ] [file...] + + ksh93 + tail [ options ] [file...] - /usr/bin/tail [ _ number [lbcf]] [file] +DESCRIPTION + tail copies one or more input files to standard output + starting at a designated point for each file. Copying starts + at the point indicated by the options and is unlimited in + size. - /usr/bin/tail [-lbcf] [file] + By default a header of the form ==> filename <== is output + before all but the first file but this can be changed with + the -q and -v options. - /usr/xpg4/bin/tail [-f | -r] [-c number | -n number] - [file] + If no file is given, or if the file is -, tail copies from + standard input. The start of the file is defined as the + current offset. - /usr/xpg4/bin/tail [ _ number [l | b | c] [f]] [file] + The option argument for -c can optionally be followed by one + of the following characters to specify a different unit other + than a single byte: + b 512 bytes. + k 1-kilobyte. + m 1-megabyte. + + Note that -c counts in bytes and not in characters (which + affects texts using multi-byte characters). - /usr/xpg4/bin/tail [ _ number [l] [f | r] ] [file] + For backwards compatibility, -number is equivalent to -n + number and +number is equivalent to -n -number + + The -b option is obsolete because of the general + non-portability of block-sized units of text. -DESCRIPTION - The tail utility copies the named file to the standard out- - put beginning at a designated place. If no file is named, - the standard input is used. - - Copying begins at a point in the file indicated by the - -cnumber, -nnumber, or _number options (if +number is speci- - fied, begins at distance number from the beginning; if - -number is specified, from the end of the input; if number - is NULL, the value 10 is assumed). number is counted in - units of lines or byte according to the -c or -n options, - or lines, blocks, or bytes, according to the appended option - l, b, or c. When no units are specified, counting is by - lines. - OPTIONS The following options are supported for both /usr/bin/tail and /usr/xpg4/bin/tail. The -r and -f options are mutually @@ -45,98 +54,62 @@ exclusive. If both are specified on the command line, the -f option is ignored. - -b Units of blocks. + -n, --lines=lines + Copy lines lines from each file. A negative + value for lines indicates an offset from the + end of the file. The default value is 10. + -b, --blocks Copy units of 512 bytes (Obsolete). + -c, --bytes[=chars] + Copy chars bytes from each file. A negative + value for chars indicates an offset from the + end of the file. The option value may be + omitted. + -f, --forever|follow + Loop forever trying to read more characters + as the end of each file to copy new data. + Ignored if reading from a pipe or fifo. + -h, --headers Output filename headers. On by default; -h + means --noheaders. + -l, --lines Copy units of lines. This is the default. + -L, --log When a --forever file times out via + --timeout, verify that the curent file has + not been renamed and replaced by another file + of the same name (a common log file practice) + before giving up on the file. + -q, --quiet Don't output filename headers. For GNU + compatibility. + -r, --reverse Output lines in reverse order. + -s, --silent Don't warn about timeout expiration and log + file changes. + -t, --timeout=timeout + Stop checking after timeout elapses with no + additional --forever output. A separate + elapsed time is maintained for each file + operand. There is no timeout by default. The + default timeout unit is seconds. timeout may + be a catenation of 1 or more integers, each + followed by a 1 character suffix. The suffix + may be omitted from the last integer, in + which case it is interpreted as seconds. The + supported suffixes are: + s seconds + m minutes + h hours + d days + w weeks + M months + y years + S scores + -v, --verbose Always ouput filename headers. + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information + If no options are specified, tail will act as if -n 10 had + been specified. - - -c Units of bytes. - - - - -f Follow. If the input-file is not a pipe, the pro- - gram does not terminate after the line of the - input-file has been copied, but enters an endless - loop, wherein it sleeps for a second and then - - - -SunOS 5.10 Last change: 13 Jul 2005 1 - - - - - - -User Commands tail(1) - - - - attempts to read and copy further records from the - input-file. Thus it can be used to monitor the - growth of a file that is being written by some - other process. - - - - -l Units of lines. - - - - -r Reverse. Copies lines from the specified starting - point in the file in reverse order. The default for - r is to print the entire file in reverse order. - - - - /usr/xpg4/bin/tail - The following options are supported for /usr/xpg4/bin/tail - only: - - -c number The number option-argument must be a decimal - integer whose sign affects the location in - the file, measured in bytes, to begin the - copying: - - - + Copying starts relative to the - beginning of the file. - - - - - - Copying starts relative to the end - of the file. - - - - none Copying starts relative to the end - of the file. - - - The origin for counting is 1; that is, -c+1 - represents the first byte of the file, -c-1 - the last. - - - -n number Equivalent to -cnumber, except the starting - location in the file is measured in lines - instead of bytes. The origin for counting is - 1. That is, -n+1 represents the first line - of the file, -n-1 the last. - - - -SunOS 5.10 Last change: 13 Jul 2005 2 - - - - - - -User Commands tail(1) - - - OPERANDS The following operand is supported: @@ -187,22 +160,6 @@ /usr/bin/tail - - - - - -SunOS 5.10 Last change: 13 Jul 2005 3 - - - - - - -User Commands tail(1) - - - ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| @@ -210,6 +167,8 @@ |_____________________________|_____________________________| | CSI | Enabled | |_____________________________|_____________________________| + | Interface Stability | See below | + |_____________________________|_____________________________| /usr/xpg4/bin/tail @@ -220,13 +179,20 @@ |_____________________________|_____________________________| | CSI | Enabled | |_____________________________|_____________________________| - | Interface Stability | Standard | + | Interface Stability | See below | |_____________________________|_____________________________| + The interface stabilty of /usr/bin/tail and + /usr/xpg4/bin/tail is Committed except for the command-line + options -q/--quiet which are Uncommited and options + -b/--blocks which are Commited Obsolete. + This command conforms to IEEE Std 1003.1-2008. + SEE ALSO - cat(1), head(1), more(1), pg(1), dd(1M), attributes(5), - environ(5), largefile(5), standards(5) + cat(1), head(1), ksh93(1), more(1), pg(1), tee(1), dd(1M), + attributes(5), environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/tail.html NOTES Piped tails relative to the end of the file are stored in a @@ -234,29 +200,6 @@ anomalous behavior can happen with character special files. - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 13 Jul 2005 4 --- tee.1.old.txt Tue Apr 21 01:43:08 2009 +++ tee.1.new.txt Tue Apr 21 01:43:08 2009 @@ -9,31 +9,43 @@ tee - replicate the standard output SYNOPSIS - tee [-ai] [file...] + /usr/bin/tee + /usr/bin/tee [ options ] [file...] + + ksh93 + tee [ options ] [file...] DESCRIPTION - The tee utility will copy standard input to standard output, - making a copy in zero or more files. tee will not buffer its - output. The options determine if the specified files are - overwritten or appended to. + tee copies standard input to standard output and to zero or + more files. The options determine whether the specified files + are overwritten or appended to. The tee utility does not + buffer output. If writes to any file fail, writes to other + files continue although tee will exit with a non-zero exit + status. + The number of file operands that can be specified is limited + by the underlying operating system. + OPTIONS - The following options are supported. + The following options are supported: - -a Appends the output to the files rather than - overwriting them. + -a, --append Append the standard input to the given files + rather than overwriting them. + -i, --ignore-interrupts + Ignore SIGINT signal. + -l, --linebuffer + Set the standard output to be line buffered + --man, --html, --nroff + Prints builtin manual page in either plain + text, HTML or nroff format. + --help Prints basic help information + --version Prints version information - - -i Ignores interrupts. - - - OPERANDS The following operands are supported: - file A path name of an output file. Processing of at - least 13 file operands will be supported. + file A path name of an output file. @@ -85,48 +97,13 @@ | Interface Stability | Standard | |_____________________________|_____________________________| + This command conforms to IEEE Std 1003.1-2008. SEE ALSO - cat(1), attributes(5), environ(5), largefile(5), stan- - dards(5) + cat(1), head(1), ksh93(1), tail(1), attributes(5), + environ(5), largefile(5), standards(5), + http://www.opengroup.org/onlinepubs/9699919799/utilities/tee.html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SunOS 5.10 Last change: 20 Dec 1996 2 - - - --- cmp.1.old.txt Thu Jan 29 03:45:05 2009 +++ cmp.1.new.txt Fri Jan 30 15:36:10 2009 @@ -9,32 +9,50 @@ cmp - compare two files SYNOPSIS - cmp [-l | -s] file1 file2 [skip1] [skip2] + /usr/bin/cmp + /usr/bin/cmp [ options ] file1 file2 [skip1] [skip2] + ksh93 + cmp [ options ] file1 file2 [skip1] [skip2] + DESCRIPTION - The cmp utility compares two files. cmp writes no output if - the files are the same. Under default options, if they - differ, it writes to standard output the byte and line - numbers at which the first difference occurred. Bytes and - lines are numbered beginning with 1. If one file is an ini- - tial subsequence of the other, that fact is noted. skip1 and - skip2 are initial byte offsets into file1 and file2 respec- - tively, and can be either octal or decimal. A leading 0 - denotes octal. + cmp compares two files file1 and file2. cmp writes no output if + the files are the same. By default, if the files differ, the byte + and line number at which the first difference occurred are + written to standard output. Bytes and lines are numbered + beginning with 1. -OPTIONS - The following options are supported: + If skip1 or skip2 are specified, or the -i option is specified, + initial bytes of the corresponding file are skipped before + beginning the compare. The skip values are in bytes or can have a + suffix of k for kilobytes or m for megabytes. - -l Write the byte number (decimal) and the differing - bytes (octal) for each difference. + If either file1 or files2 is -, cmp uses standard input starting + at the current location. +OPTIONS + The following options are supported: - -s Write nothing for differing files. Return exit - status only. + -c, --print-chars + Writes control characters as a ^ followed by a + letter of the alphabet and precede characters + that have the high bit set with M-. + -i, --ignore-initial=skip + Sets default skip values for the operands skip1 + and skip2 to skip. The default value is 0. + -l, --verbose Write the decimal byte number and the differing + bytes (in octal) for each difference. + -s, --quiet|silent + Write nothing for differing files; return + non-zero exit status only. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information - OPERANDS The following operands are supported: @@ -120,7 +138,7 @@ SEE ALSO - comm(1), diff(1), attributes(5), environ(5), largefile(5), + comm(1), diff(1), ksh93(1), attributes(5), environ(5), largefile(5), standards(5) --- comm.1.old.txt Thu Jan 29 03:45:06 2009 +++ comm.1.new.txt Thu Jan 29 04:58:58 2009 @@ -9,37 +9,49 @@ comm - select or reject lines common to two files SYNOPSIS - comm [-123] file1 file2 + /usr/bin/comm + /usr/bin/comm [ options ] file1 file2 + ksh93 + comm [ options ] file1 file2 + + DESCRIPTION - The comm utility reads file1 and file2, which must be - ordered in the current collating sequence, and produces - three text columns as output: lines only in file1; lines - only in file2; and lines in both files. + comm reads two files file1 and file2 which should be ordered in + the collating sequence of the current locale, and produces three + text columns as output: + 1 Lines only in file1. + 2 Lines only in file2. + 3 Lines in both files. - If the input files were ordered according to the collating - sequence of the current locale, the lines written will be in - the collating sequence of the original lines. If not, the - results are unspecified. + If lines in either file are not ordered according to the + collating sequence of the current locale, the results are not + specified. -OPTIONS - The following options are supported: + If either file1 or file2 is -, comm uses standard input starting + at the current location. - -1 Suppresses the output column of lines unique to - file1. +OPTIONS + The following options are supported: - -2 Suppresses the output column of lines unique to - file2. + -1 Suppress the output column of lines unique to + file1. + -2 Suppress the output column of lines unique to + file2. + -3 Suppress the output column of lines duplicate in + file1 and file2. - -3 Suppresses the output column of lines duplicated in - file1 and file2. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information - OPERANDS The following operands are supported: @@ -116,7 +128,7 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| - | Availability | SUNWesu | + | Availability | SUNWcsu | |_____________________________|_____________________________| | CSI | enabled | |_____________________________|_____________________________| @@ -138,7 +150,7 @@ SEE ALSO - cmp(1), diff(1), sort(1), uniq(1), attributes(5), + cmp(1), diff(1), ksh93(1), sort(1), uniq(1), attributes(5), environ(5), largefile(5), standards(5) --- cut.1.old.txt Thu Jan 29 03:45:07 2009 +++ cut.1.new.txt Fri Jan 30 14:52:13 2009 @@ -9,99 +9,79 @@ cut - cut out selected fields of each line of a file SYNOPSIS - cut -b list [-n] [file...] + /usr/bin/cut + /usr/bin/cut [ options ] [file ...] - cut -c list [file...] - cut -f list [-d delim] [-s] [file...] + ksh93 + cut [ options ] [file ...] DESCRIPTION - Use the cut utility to cut out columns from a table or - fields from each line of a file; in data base parlance, it - implements the projection of a relation. The fields as - specified by list can be fixed length, that is, character - positions as on a punched card (-c option) or the length can - vary from line to line and be marked with a field delimiter - character like <TAB> (-f option). cut can be used as a - filter. + cut bytes, characters, or character-delimited fields from one or + more files, contatenating them on standard output. - Either the -b, -c, or -f option must be specified. + The option argument list is a comma-separated or blank-separated + list of positive numbers and ranges. Ranges can be of three + forms. The first is two positive integers separated by a hyphen + (low-high), which represents all fields from low to high. The + second is a positive number preceded by a hyphen (-high), which + represents all fields from field 1 to high. The last is a + positive number followed by a hyphen (low-), which represents all + fields from low to the last field, inclusive. Elements in the + list can be repeated, can overlap, and can appear in any order. + The order of the output is that of the input. - Use grep(1) to make horizontal ``cuts'' (by context) through - a file, or paste(1) to put files together column-wise (that - is, horizontally). To reorder columns in a table, use cut - and paste. + One and only one of -b, -c, or -f must be specified. + If no file is given, or if the file is -, cut cuts from standard + input. The start of the file is defined as the current offset. + + OPTIONS The following options are supported: - list A comma-separated or blank-character- - separated list of integer field numbers (in - increasing order), with optional - to indi- - cate ranges (for instance, 1,4,7; 1-3,8; - -5,10 (short for 1-5,10); or 3- (short for - third through last field)). + -b, --bytes=list + cut based on a list of bytes. + -c, --characters=list + cut based on a list of characters. + -d, --delimiter=delim + The field character for the -f option is set to + delim. The default is the tab character. - -b list The list following -b specifies byte posi- - tions (for instance, -b1-72 would pass the - first 72 bytes of each line). When -b and -n - are used together, list is adjusted so that - no multi-byte character is split. + -f, --fields=list + cut based on fields separated by the delimiter + character specified with the -d optiion. + -n, --nosplit Do not split characters. + -R|r, --reclen=reclen + If reclen > 0, the input will be read as fixed + length records of length reclen when used with + the -b or -c option. - -c list The list following -c specifies character - positions (for instance, -c1-72 would pass - the first 72 characters of each line). + -s, --suppress|only-delimited + Suppress lines with no delimiter characters, when + used with the -f option. By default, lines with + no delimiters will be passsed in untouched. + -D, --line-delimeter|output-delimiter=ldelim + The line delimiter character for the -f option is + set to ldelim. The default is the newline + character. + -N, --nonewline Do not output new-lines at end of each record + when used with the -b or -c option. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information -SunOS 5.10 Last change: 29 Apr 1999 1 - - - - - -User Commands cut(1) - - - - -d delim The character following -d is the field del- - imiter (-f option only). Default is tab. - Space or other characters with special mean- - ing to the shell must be quoted. delim can - be a multi-byte character. - - - - -f list The list following -f is a list of fields - assumed to be separated in the file by a - delimiter character (see -d ); for instance, - -f1,7 copies the first and seventh field - only. Lines with no field delimiters will be - passed through intact (useful for table sub- - headings), unless -s is specified. - - - - -n Do not split characters. When -b list and -n - are used together, list is adjusted so that - no multi-byte character is split. - - - - -s Suppresses lines with no delimiter charac- - ters in case of -f option. Unless specified, - lines with no delimiters will be passed - through untouched. - - - OPERANDS The following operands are supported: @@ -141,7 +121,7 @@ To set name to current login name: - example$ name=`who am i | cut -f1 -d' '` + example$ name=$(who am i | cut -f1 -d' ') ENVIRONMENT VARIABLES See environ(5) for descriptions of the following environment @@ -175,88 +155,10 @@ SEE ALSO - grep(1), paste(1), attributes(5), environ(5), largefile(5), - standards(5) + grep(1), paste(1), ksh93(1), attributes(5), environ(5), + largefile(5), standards(5) -DIAGNOSTICS - cut: -n may only be used with -b - - cut: -d may only be used with -f - - - cut: -s may only be used with -f - - - - - - -SunOS 5.10 Last change: 29 Apr 1999 3 - - - - - - -User Commands cut(1) - - - - cut: cannot open <file> Either file cannot - be read or does not - exist. If multiple - files are present, - processing contin- - ues. - - - - cut: no delimiter specified Missing delim on -d - option. - - - - cut: invalid delimiter - - - cut: no list specified Missing list on -b, - -c, or -f option. - - - - cut: invalid range specifier - - - cut: too many ranges specified - - - cut: range must be increasing - - - cut: invalid character in range - - - cut: internal error processing input - - - cut: invalid multibyte character - - - cut: unable to allocate enough memory - - - - - - - - - - - - - SunOS 5.10 Last change: 29 Apr 1999 4 --- paste.1.old.txt Thu Jan 29 03:45:07 2009 +++ paste.1.new.txt Thu Jan 29 04:58:45 2009 @@ -9,109 +9,61 @@ paste - merge corresponding or subsequent lines of files SYNOPSIS - paste [-s] [-d list] file... + /usr/bin/paste + /usr/bin/paste [ options ] [file ...] -DESCRIPTION - The paste utility will concatenate the corresponding lines - of the given input files, and write the resulting lines to - standard output. - The default operation of paste will concatenate the - corresponding lines of the input files. The NEWLINE charac- - ter of every line except the line from the last input file - will be replaced with a TAB character. + ksh93 + paste [ options ] [file ...] - If an EOF (end-of-file) condition is detected on one or more - input files, but not all input files, paste will behave as - though empty lines were read from the files on which EOF was - detected, unless the -s option is specified. +DESCRIPTION + paste concatenates the corresponding lines of a given input file + and writes the resulting lines to standard output. By default + paste replaces the newline character of every line other than the + last input file with the TAB character. -OPTIONS - The following options are supported: + Unless the -s option is specified, if an end-of-file is + encountered on one or more input files, but not all input files, + paste behaves as if empty lines were read from the file(s) on + which end-of-file was detected. - -d list Unless a backslash character (\) appears in list, - each character in list is an element specifying a - delimiter character. If a backslash character - appears in list, the backslash character and one or - more characters following it are an element speci- - fying a delimiter character as described below. - These elements specify one or more delimiters to - use, instead of the default TAB character, to - replace the NEWLINE character of the input lines. - The elements in list are used circularly. That is, - when the list is exhausted, the first element from - the list is reused. + Unless the -s option is specified, paste is limited by the + underlying operating system on how many file operands can be + specified. - When the -s option is specified: + If no file operands are given or if the file is -, paste reads + from standard input. The start of the file is defined as the + current offset. - o The last newline character in a file will not - be modified. +OPTIONS + The following options are supported: - o The delimiter will be reset to the first ele- - ment of list after each file operand is pro- - cessed. + -s, --serial Paste the lines of one file at a time rather than + one line from each file. In this case if the -d + option is specified the delimiter will be reset + to the first in the list at the beginning of each + file. - When the option is not specified: + -d, --delimiters=list + list specifies a list of delimiters. These + delimiters are used circularly instead of TAB to + replace the newline character of the input lines. + Unless the -s option is specified, the delimiter + will be reset to the first element of list each + time a line is processed from each file. The + delimiter characters corresponding to list will + be found by treating list as an ANSI-C string, + except that the \0 sequence will insert the empty + string instead of the null character. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information - o The NEWLINE characters in the file specified - by the last file will not be modified. - - -SunOS 5.10 Last change: 20 Dec 1996 1 - - - - - - -User Commands paste(1) - - - - o The delimiter will be reset to the first ele- - ment of list each time a line is processed - from each file. - - If a backslash character appears in list, it and - the character following it will be used to - represent the following delimiter characters: - - - \n Newline character. - - - - - \t Tab character. - - - - \\ Backslash character. - - - - \0 Empty string (not a null character). If \0 - is immediately followed by the character - x, the character X, or any character - defined by the LC_CTYPE digit keyword, the - results are unspecified. - - - If any other characters follow the backslash, the - results are unspecified. - - - -s Concatenate all of the lines of each separate input - file in command line order. The NEWLINE character - of every line except the last line in each input - file will be replaced with the TAB character, - unless otherwise specified by the -d option. - - - OPERANDS The following operand is supported: @@ -119,8 +71,6 @@ one or more of the files, the standard input will be used. The standard input will be read one line at a time, circularly, for each instance of -. - Implementations support pasting of at least 12 file - operands. @@ -179,7 +129,7 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| - | Availability | SUNWesu | + | Availability | SUNWcsu | |_____________________________|_____________________________| | CSI | Enabled | |_____________________________|_____________________________| @@ -188,77 +138,9 @@ SEE ALSO + cut(1), grep(1), ksh93(1), pr(1), attributes(5 environ(5), + largefile(5), standards(5) - -SunOS 5.10 Last change: 20 Dec 1996 3 - - - - - - -User Commands paste(1) - - - - cut(1), grep(1), pr(1), attributes(5), environ(5), large- - file(5), standards(5) - -DIAGNOSTICS - "line too long" Output lines are restricted to 511 - characters. - - - - "too many files" Except for -s option, no more than - 12 input files may be specified. - - - - "no delimiters" The -d option was specified with an - empty list. - - - - "cannot open file" The specified file cannot be opened. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -SunOS 5.10 Last change: 20 Dec 1996 4 - - --- print.1.old.txt Fri Jan 30 15:26:43 2009 +++ print.1.new.txt Fri Jan 30 15:34:05 2009 @@ -10,12 +10,14 @@ screen or window SYNOPSIS + /usr/bin/print + print [-CRenprsv] [-f format] [-u fd] [string...] + ksh print [-Rnprsu [n]] [arg]... - ksh93 - print [-Renprs] [-f format] [-u fd] [string...] + print [-CRenprsv] [-f format] [-u fd] [string...] DESCRIPTION @@ -24,7 +26,7 @@ -, the arguments are printed on standard output as described by echo(1). - ksh93 + /usr/bin/print, ksh93 print By default, print writes each string operand to standard output and appends a NEWLINE character. @@ -164,7 +166,13 @@ -u fd Write to file descriptor number fd instead of standard output. The default value is 1. + -v Treat each string as a variable name and write + the value in %B format. Cannot be used with -f. + -C Treat each string as a variable name and write + the value in %#B format. Cannot be used with -f. + + EXIT STATUS The following exit values are returned: --- read.1.old.txt Fri Jan 30 15:26:43 2009 +++ read.1.new.txt Fri Jan 30 16:40:56 2009 @@ -25,7 +25,7 @@ ksh93 - read [-Aprs] [-d delim] [-n nsize] [-N nsize] [-t timeout][-u unit] [vname?prompt] [vname... ] + read [-ACprs] [-d delim] [-n nsize] [-N nsize] [-t timeout][-u unit] [vname?prompt] [vname... ] DESCRIPTION @@ -187,6 +187,8 @@ index 0. + -C Unset var and read var as a compound variable. + -d delim Read until delimiter delim instead of to the end of line. --- typeset.1.old.txt Fri Jan 30 15:26:43 2009 +++ typeset.1.new.txt Fri Jan 30 15:31:09 2009 @@ -10,7 +10,7 @@ butes and values for shell variables and functions SYNOPSIS - typeset [_ HLRZfilrtux [n]] [name [= value]]... + typeset [_ CDHLRZfilrtux [n]] [name [= value]]... whence [-pv] name... @@ -23,6 +23,13 @@ value and type are restored when the function completes. The following list of attributes may be specified: + -C Compound variable. Each name will be a compound + variable. If value names a compound variable it + will be copied to name. Otherwise if the variable + already exists, it will first be unset + + -D Reserved for future usage. + -H This flag provides UNIX to host-name file mapping on non-UNIX machines. @@ -86,6 +93,10 @@ -l All upper-case characters are converted to lower- case. The upper-case flag, -u is turned off. + -m Move. The value is the name of a variable whose + value will be moved to name. The orignal variable + will be unset. Cannot be used with any other + options. -r The given names are marked readonly and these names cannot be changed by subsequent assignment. @@ -174,7 +185,7 @@ SEE ALSO - ksh(1), set(1), sh(1), attributes(5) + ksh(1), ksh93(1), set(1), sh(1), attributes(5) --- uniq.1.old.txt Thu Jan 29 03:45:08 2009 +++ uniq.1.new.txt Fri Jan 30 15:17:20 2009 @@ -9,89 +9,77 @@ uniq - report or filter out repeated lines in a file SYNOPSIS - uniq [-c | -d | -u] [-f fields] [-s char] [ input_file - [output_file]] + /usr/bin/uniq + /usr/bin/uniq [ options ] [infile [outfile]] - uniq [-c | -d | -u] [-n] [ + m] [ input_file - [output_file]] + ksh93 + uniq [ options ] [infile [outfile]] + DESCRIPTION - The uniq utility will read an input file comparing adjacent - lines, and write one copy of each input line on the output. - The second and succeeding copies of repeated adjacent input - lines will not be written. + uniq reads an input, comparing adjacent lines, and writing one + copy of each input line on the output. The second and succeeding + copies of the repeated adjacent lines are not written. - Repeated lines in the input will not be detected if they are - not adjacent. + If the output file, outfile, is not specified, uniq writes to + standard output. If no infile is given, or if the infile is -, + uniq reads from standard input with the start of the file is + defined as the current offset. OPTIONS The following options are supported: - -c Precedes each output line with a count of - the number of times the line occurred in the - input. + -c, --count Output the number of times each line occurred + along with the line. + -d, --repeated|duplicates + Output the first of each duplicate line. + -D, --all-repeated[=delimit] + Output all duplicate lines as a group with an + empty line delimiter specified by delimit: + none Do not delimit duplicate groups. + prepend + Prepend an empty line before each group. + separate + Separate each group with an empty line. + e option value may be omitted. The default value + is none. - -d Suppresses the writing of lines that are not - repeated in the input. + -f, --skip-fields=fields + fields is the number of fields to skip over + before checking for uniqueness. A field is the + minimal string matching the BRE + [[:blank:]]*[^[:blank:]]*. + -i, --ignore-case + Ignore case in comparisons. + -s, --skip-chars=chars + chars is the number of characters to skip over + before checking for uniqueness. If specified + along with -f, the first chars after the first + fields are ignored. If the chars specifies more + characters than are on the line, an empty string + will be used for comparison. - -f fields Ignores the first fields fields on each - input line when doing comparisons, where - fields is a positive decimal integer. A - field is the maximal string matched by the - basic regular expression: + -u, --unique Output unique lines. + -w, --check-chars=chars + chars is the number of characters to compare + after skipping any specified fields and + characters. - [[:blank:]]*[^[:blank:]]* + -n Equivalent to -f fields with fields set to n. - If fields specifies more fields than appear - on an input line, a null string will be used - for comparison. - - - - -s chars Ignores the first chars characters when - doing comparisons, where chars is a positive - decimal integer. If specified in conjunction - with the -f option, the first chars - - - -SunOS 5.10 Last change: 20 Dec 1996 1 - - - - - - -User Commands uniq(1) - - - - characters after the first fields fields - will be ignored. If chars specifies more - characters than remain on an input line, a - null string will be used for comparison. - - - - -u Suppresses the writing of lines that are - repeated in the input. - - - - -n Equivalent to -f fields with fields set to - n. - - - +m Equivalent to -s chars with chars set to m. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information - OPERANDS The following operands are supported: @@ -206,7 +194,7 @@ ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| - | Availability | SUNWesu | + | Availability | SUNWcsu | |_____________________________|_____________________________| | CSI | Enabled | |_____________________________|_____________________________| @@ -215,8 +203,8 @@ SEE ALSO - comm(1), pack(1), pcat(1), sort(1), uncompress(1), attri- - butes(5), environ(5), standards(5) + comm(1), pack(1), pcat(1), ksh93(1), sort(1), uncompress(1), + attributes(5), environ(5), standards(5) --- wc.1.old.txt Thu Jan 29 03:45:09 2009 +++ wc.1.new.txt Thu Jan 29 05:01:56 2009 @@ -10,46 +10,60 @@ file SYNOPSIS - wc [-c | -m | -C] [-lw] [file...] + /usr/bin/wc + /usr/bin/wc [ options ] [file ...] -DESCRIPTION - The wc utility reads one or more input files and, by - default, writes the number of newline characters, words and - bytes contained in each input file to the standard output. - The utility also writes a total count for all named files, - if more than one input file is specified. + ksh93 + wc [ options ] [file ...] - wc considers a word to be a non-zero-length string of char- - acters delimited by white space (for example, SPACE, TAB). - See iswspace(3C) or isspace(3C). +DESCRIPTION + wc reads one or more input files and, by default, for each file + writes a line containing the number of newlines, words, and bytes + contained in each file followed by the file name to standard + output in that order. A word is defined to be a non-zero length + string delimited by iswspace(3C) or isspace(3C) characters. -OPTIONS - The following options are supported: + If more than one file is specified, wc writes a total count for + all of the named files with total written instead of the file + name. - -c Counts bytes. + By default, wc writes all three counts. Options can specified so + that only certain counts are written. The options -c and -m are + mutually exclusive. + If no file is given, or if the file is -, wc reads from standard + input and no filename is written to standard output. The start of + the file is defined as the current offset. - -C Same as -m. +OPTIONS + The following options are supported: + -l, --lines List the line counts. + -w, --words List the word counts. Delimiting characters + are Extended Unix Code (EUC) characters from any code + set defined by iswspace(). - -l Counts lines. + -c, --bytes|chars + List the byte counts. + -m|C, --multibyte-chars + List the character counts. + -q, --quiet Suppress invalid multibyte character warnings. - -m Counts characters. + -L, --longest-line|max-line-length + List the longest line length. + --man, --html, --nroff + Prints builtin manual page in either plain text, + HTML or nroff format. + --help Prints basic help information + --version Prints version information - -w Counts words delimited by white space characters or - new line characters. Delimiting characters are - Extended Unix Code (EUC) characters from any code - set defined by iswspace(). - - - If no option is specified, the default is -lwc (counts lines, words, and bytes.) @@ -113,7 +127,7 @@ SEE ALSO - cksum(1), isspace(3C), iswalpha(3C), iswspace(3C), + cksum(1), ksh93(1), isspace(3C), iswalpha(3C), iswspace(3C), setlocale(3C), attributes(5), environ(5), largefile(5), standards(5)
