man pages section 1: User Commands

Part No: 816516516 September 2010

Copyright 2010, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are commercial computer software or commercial technical data pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd. This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

100617@24378

Contents

Preface ...................................................................................................................................................19

Introduction .........................................................................................................................................23 Intro(1) ................................................................................................................................................ 24

User Commands ...................................................................................................................................29 acctcom(1) ............................................................................................................................................ 30 adb(1) .................................................................................................................................................... 33 addbib(1) .............................................................................................................................................. 34 alias(1) ................................................................................................................................................ 36 allocate(1) ......................................................................................................................................... 39 amt(1) .................................................................................................................................................... 41 answerbook2(1) ................................................................................................................................... 42 appcert(1) ............................................................................................................................................ 43 apptrace(1) ......................................................................................................................................... 50 apropos(1) ............................................................................................................................................ 54 ar(1) ...................................................................................................................................................... 56 arch(1) .................................................................................................................................................. 60 as(1) ...................................................................................................................................................... 61 asa(1) .................................................................................................................................................... 66 at(1) ...................................................................................................................................................... 68 atq(1) .................................................................................................................................................... 75 atrm(1) .................................................................................................................................................. 76 audioconvert(1) ................................................................................................................................. 77 audioplay(1) ....................................................................................................................................... 81 audiorecord(1) ................................................................................................................................... 84 auths(1) ................................................................................................................................................ 873

Contents

auto_ef(1) ............................................................................................................................................ 89 awk(1) .................................................................................................................................................... 92 banner(1) .............................................................................................................................................. 98 basename(1) ......................................................................................................................................... 99 basename(1B) ..................................................................................................................................... 101 bc(1) .................................................................................................................................................... 102 bdiff(1) .............................................................................................................................................. 106 bfs(1) .................................................................................................................................................. 107 biff(1B) ............................................................................................................................................. 111 break(1) .............................................................................................................................................. 112 cal(1) .................................................................................................................................................. 114 calendar(1) ....................................................................................................................................... 115 cancel(1) ............................................................................................................................................ 117 cat(1) .................................................................................................................................................. 119 cc(1B) .................................................................................................................................................. 122 cd(1) .................................................................................................................................................... 124 cdrw(1) ................................................................................................................................................ 128 checknr(1) .......................................................................................................................................... 135 chgrp(1) .............................................................................................................................................. 137 chkey(1) .............................................................................................................................................. 140 chmod(1) .............................................................................................................................................. 142 chown(1) .............................................................................................................................................. 161 chown(1B) ........................................................................................................................................... 164 ckdate(1) ............................................................................................................................................ 165 ckgid(1) .............................................................................................................................................. 168 ckint(1) .............................................................................................................................................. 170 ckitem(1) ............................................................................................................................................ 172 ckkeywd(1) .......................................................................................................................................... 175 ckpath(1) ............................................................................................................................................ 177 ckrange(1) .......................................................................................................................................... 181 ckstr(1) .............................................................................................................................................. 184 cksum(1) .............................................................................................................................................. 187 cktime(1) ............................................................................................................................................ 189 ckuid(1) .............................................................................................................................................. 191 ckyorn(1) ............................................................................................................................................ 193 clear(1) .............................................................................................................................................. 1954 man pages section 1: User Commands September 2010

Contents

cmp(1) .................................................................................................................................................. 196 col(1) .................................................................................................................................................. 198 comm(1) ................................................................................................................................................ 200 command(1) .......................................................................................................................................... 202 compress(1) ....................................................................................................................................... 205 coproc(1F) ......................................................................................................................................... 208 cp(1) .................................................................................................................................................... 212 cpio(1) ................................................................................................................................................ 217 cpp(1) .................................................................................................................................................. 225 cputrack(1) ....................................................................................................................................... 231 crle(1) ................................................................................................................................................ 236 crontab(1) .......................................................................................................................................... 246 crypt(1) .............................................................................................................................................. 251 csh(1) .................................................................................................................................................. 252 csplit(1) ............................................................................................................................................ 278 ct(1C) ................................................................................................................................................. 281 ctags(1) .............................................................................................................................................. 283 ctrun(1) .............................................................................................................................................. 286 ctstat(1) ............................................................................................................................................ 289 ctwatch(1) .......................................................................................................................................... 292 cu(1C) ................................................................................................................................................. 294 cut(1) .................................................................................................................................................. 301 date(1) ................................................................................................................................................ 304 dc(1) .................................................................................................................................................... 308 deallocate(1) ................................................................................................................................... 311 deroff(1) ............................................................................................................................................ 313 df(1B) .................................................................................................................................................. 314 dhcpinfo(1) ....................................................................................................................................... 316 diff(1) ................................................................................................................................................ 319 diff3(1) .............................................................................................................................................. 323 diffmk(1) ............................................................................................................................................ 325 digest(1) ............................................................................................................................................ 326 dircmp(1) ............................................................................................................................................ 328 dis(1) .................................................................................................................................................. 329 dispgid(1) .......................................................................................................................................... 331 dispuid(1) .......................................................................................................................................... 3325

Contents

dos2unix(1) ....................................................................................................................................... 333 download(1) ....................................................................................................................................... 335 dpost(1) .............................................................................................................................................. 337 dtappsession(1) ............................................................................................................................... 340 du(1) .................................................................................................................................................... 342 du(1B) .................................................................................................................................................. 345 dump(1) ................................................................................................................................................ 347 dumpcs(1) ............................................................................................................................................ 350 echo(1) ................................................................................................................................................ 351 echo(1B) ............................................................................................................................................. 354 echo(1F) .............................................................................................................................................. 355 ed(1) .................................................................................................................................................... 356 edit(1) ................................................................................................................................................ 370 egrep(1) .............................................................................................................................................. 375 eject(1) .............................................................................................................................................. 378 elfdump(1) .......................................................................................................................................... 381 elfsign(1) .......................................................................................................................................... 383 enable(1) ............................................................................................................................................ 388 encrypt(1) .......................................................................................................................................... 390 enhance(1) .......................................................................................................................................... 393 env(1) .................................................................................................................................................. 395 eqn(1) .................................................................................................................................................. 397 error(1) .............................................................................................................................................. 401 ex(1) .................................................................................................................................................... 404 exec(1) ................................................................................................................................................ 415 exit(1) ................................................................................................................................................ 417 expand(1) ............................................................................................................................................ 419 exportfs(1B) ..................................................................................................................................... 421 expr(1) ................................................................................................................................................ 422 expr(1B) ............................................................................................................................................. 426 exstr(1) .............................................................................................................................................. 429 face(1) ................................................................................................................................................ 433 factor(1) ............................................................................................................................................ 434 fastboot(1B) ..................................................................................................................................... 435 fdformat(1) ....................................................................................................................................... 436 fgrep(1) .............................................................................................................................................. 4406 man pages section 1: User Commands September 2010

Contents

file(1) ................................................................................................................................................ 443 file(1B) ............................................................................................................................................. 446 filesync(1) ....................................................................................................................................... 448 find(1) ................................................................................................................................................ 456 finger(1) ............................................................................................................................................ 464 fmlcut(1F) ......................................................................................................................................... 467 fmlexpr(1F) ....................................................................................................................................... 469 fmlgrep(1F) ....................................................................................................................................... 472 fmli(1) ................................................................................................................................................ 474 fmt(1) .................................................................................................................................................. 476 fmtmsg(1) ............................................................................................................................................ 477 fold(1) ................................................................................................................................................ 481 from(1B) ............................................................................................................................................. 483 ftp(1) .................................................................................................................................................. 484 ftpcount(1) ....................................................................................................................................... 499 ftpwho(1) ............................................................................................................................................ 500 gcore(1) .............................................................................................................................................. 501 gencat(1) ............................................................................................................................................ 503 geniconvtbl(1) ................................................................................................................................. 506 genlayouttbl(1) ............................................................................................................................... 509 genmsg(1) ............................................................................................................................................ 525 getconf(1) .......................................................................................................................................... 531 getfacl(1) .......................................................................................................................................... 538 getfrm(1F) ......................................................................................................................................... 542 getitems(1F) ..................................................................................................................................... 543 getlabel(1) ....................................................................................................................................... 544 getopt(1) ............................................................................................................................................ 545 getoptcvt(1) ..................................................................................................................................... 547 getopts(1) .......................................................................................................................................... 550 gettext(1) .......................................................................................................................................... 556 gettxt(1) ............................................................................................................................................ 558 getzonepath(1) ................................................................................................................................. 560 glob(1) ................................................................................................................................................ 561 gprof(1) .............................................................................................................................................. 562 graph(1) .............................................................................................................................................. 567 grep(1) ................................................................................................................................................ 5697

Contents

groups(1) ............................................................................................................................................ 574 groups(1B) ......................................................................................................................................... 575 grpck(1B) ........................................................................................................................................... 576 hash(1) ................................................................................................................................................ 577 head(1) ................................................................................................................................................ 579 history(1) .......................................................................................................................................... 581 hostid(1) ............................................................................................................................................ 590 hostname(1) ....................................................................................................................................... 591 iconv(1) .............................................................................................................................................. 592 idnconv(1) .......................................................................................................................................... 595 indicator(1F) ................................................................................................................................... 600 indxbib(1) .......................................................................................................................................... 602 install(1B) ....................................................................................................................................... 603 ipcrm(1) .............................................................................................................................................. 605 ipcs(1) ................................................................................................................................................ 607 isainfo(1) .......................................................................................................................................... 611 isalist(1) .......................................................................................................................................... 613 jobs(1) ................................................................................................................................................ 614 join(1) ................................................................................................................................................ 621 kbd(1) .................................................................................................................................................. 624 kdestroy(1) ....................................................................................................................................... 630 keylogin(1) ....................................................................................................................................... 632 keylogout(1) ..................................................................................................................................... 634 kill(1) ................................................................................................................................................ 635 kinit(1) .............................................................................................................................................. 639 klist(1) .............................................................................................................................................. 644 kmdb(1) ................................................................................................................................................ 646 kmfcfg(1) ............................................................................................................................................ 652 kpasswd(1) .......................................................................................................................................... 660 krb5-config(1) ................................................................................................................................. 661 ksh(1) .................................................................................................................................................. 663 ktutil(1) ............................................................................................................................................ 714 lari(1) ................................................................................................................................................ 716 last(1) ................................................................................................................................................ 723 lastcomm(1) ....................................................................................................................................... 725 ld(1) .................................................................................................................................................... 7278 man pages section 1: User Commands September 2010

Contents

ld(1B) .................................................................................................................................................. 740 ldap(1) ................................................................................................................................................ 741 ldapdelete(1) ................................................................................................................................... 745 ldaplist(1) ....................................................................................................................................... 751 ldapmodify(1) ................................................................................................................................... 755 ldapmodrdn(1) ................................................................................................................................... 763 ldapsearch(1) ................................................................................................................................... 769 ldd(1) .................................................................................................................................................. 779 ld.so.1(1) .......................................................................................................................................... 784 let(1) .................................................................................................................................................. 792 lex(1) .................................................................................................................................................. 793 limit(1) .............................................................................................................................................. 805 line(1) ................................................................................................................................................ 810 lint(1B) ............................................................................................................................................. 811 list_devices(1) ............................................................................................................................... 813 listusers(1) ..................................................................................................................................... 817 llc2_autoconfig(1) ......................................................................................................................... 818 llc2_config(1) ................................................................................................................................. 819 llc2_stats(1) ................................................................................................................................... 821 ln(1) .................................................................................................................................................... 829 ln(1B) .................................................................................................................................................. 832 loadkeys(1) ....................................................................................................................................... 835 locale(1) ............................................................................................................................................ 836 localedef(1) ..................................................................................................................................... 839 logger(1) ............................................................................................................................................ 844 logger(1B) ......................................................................................................................................... 846 login(1) .............................................................................................................................................. 848 logname(1) .......................................................................................................................................... 856 logout(1) ............................................................................................................................................ 857 look(1) ................................................................................................................................................ 858 lookbib(1) .......................................................................................................................................... 859 lorder(1) ............................................................................................................................................ 860 lp(1) .................................................................................................................................................... 861 lpc(1B) ............................................................................................................................................... 869 lpq(1B) ............................................................................................................................................... 873 lpr(1B) ............................................................................................................................................... 8759

Contents

lprm(1B) ............................................................................................................................................. 878 lpstat(1) ............................................................................................................................................ 880 lptest(1B) ......................................................................................................................................... 884 ls(1) .................................................................................................................................................... 885 ls(1B) .................................................................................................................................................. 896 m4(1) .................................................................................................................................................... 899 mac(1) .................................................................................................................................................. 905 mach(1) ................................................................................................................................................ 907 machid(1) ............................................................................................................................................ 908 madv.so.1(1) ..................................................................................................................................... 910 mail(1) ................................................................................................................................................ 914 mail(1B) ............................................................................................................................................. 920 mailcompat(1) ................................................................................................................................... 921 mailp(1) .............................................................................................................................................. 923 mailq(1) .............................................................................................................................................. 925 mailstats(1) ..................................................................................................................................... 927 mailx(1) .............................................................................................................................................. 929 make(1S) .............................................................................................................................................. 954 man(1) .................................................................................................................................................. 989 mconnect(1) ....................................................................................................................................... 995 mcs(1) .................................................................................................................................................. 996 mdb(1) .................................................................................................................................................. 998 mesg(1) .............................................................................................................................................. 1042 message(1F) ..................................................................................................................................... 1043 mixerctl(1) ..................................................................................................................................... 1045 mkdir(1) ............................................................................................................................................ 1047 mkmsgs(1) .......................................................................................................................................... 1049 mkstr(1B) ......................................................................................................................................... 1051 mktemp(1) .......................................................................................................................................... 1053 moe(1) ................................................................................................................................................ 1056 more(1) .............................................................................................................................................. 1058 mp(1) .................................................................................................................................................. 1065 mpss.so.1(1) ................................................................................................................................... 1073 msgfmt(1) .......................................................................................................................................... 1076 mt(1) .................................................................................................................................................. 1082 mv(1) .................................................................................................................................................. 108510 man pages section 1: User Commands September 2010

Contents

nawk(1) .............................................................................................................................................. 1088 nca(1) ................................................................................................................................................ 1109 ncab2clf(1) ..................................................................................................................................... 1111 ncakmod(1) ........................................................................................................................................ 1113 newform(1) ........................................................................................................................................ 1114 newgrp(1) .......................................................................................................................................... 1117 news(1) .............................................................................................................................................. 1119 newtask(1) ........................................................................................................................................ 1120 nice(1) .............................................................................................................................................. 1122 NIS+(1) .............................................................................................................................................. 1124 niscat(1) .......................................................................................................................................... 1139 nischgrp(1) ..................................................................................................................................... 1142 nischmod(1) ..................................................................................................................................... 1144 nischown(1) ..................................................................................................................................... 1147 nischttl(1) ..................................................................................................................................... 1149 nisdefaults(1) ............................................................................................................................... 1151 niserror(1) ..................................................................................................................................... 1154 nisgrpadm(1) ................................................................................................................................... 1155 nisln(1) ............................................................................................................................................ 1159 nisls(1) ............................................................................................................................................ 1161 nismatch(1) ..................................................................................................................................... 1163 nismkdir(1) ..................................................................................................................................... 1166 nisopaccess(1) ............................................................................................................................... 1169 nispasswd(1) ................................................................................................................................... 1172 nisrm(1) ............................................................................................................................................ 1176 nisrmdir(1) ..................................................................................................................................... 1178 nistbladm(1) ................................................................................................................................... 1180 nistest(1) ........................................................................................................................................ 1186 nl(1) .................................................................................................................................................. 1188 nm(1) .................................................................................................................................................. 1191 nohup(1) ............................................................................................................................................ 1196 nroff(1) ............................................................................................................................................ 1200 od(1) .................................................................................................................................................. 1203 on(1) .................................................................................................................................................. 1210 optisa(1) .......................................................................................................................................... 1212 pack(1) .............................................................................................................................................. 121311

Contents

pagesize(1) ..................................................................................................................................... 1216 pargs(1) ............................................................................................................................................ 1217 passwd(1) .......................................................................................................................................... 1219 paste(1) ............................................................................................................................................ 1227 patch(1) ............................................................................................................................................ 1230 pathchk(1) ........................................................................................................................................ 1235 pathconv(1F) ................................................................................................................................... 1238 pax(1) ................................................................................................................................................ 1240 perl(1) .............................................................................................................................................. 1272 pfexec(1) .......................................................................................................................................... 1279 pg(1) .................................................................................................................................................. 1281 pgrep(1) ............................................................................................................................................ 1286 pkginfo(1) ........................................................................................................................................ 1290 pkgmk(1) ............................................................................................................................................ 1292 pkgparam(1) ..................................................................................................................................... 1295 pkgproto(1) ..................................................................................................................................... 1297 pkgtrans(1) ..................................................................................................................................... 1299 pktool(1) .......................................................................................................................................... 1303 plabel(1) .......................................................................................................................................... 1318 plimit(1) .......................................................................................................................................... 1319 plot(1B) ........................................................................................................................................... 1321 pmap(1) .............................................................................................................................................. 1323 postdaisy(1) ................................................................................................................................... 1332 postdmd(1) ........................................................................................................................................ 1334 postio(1) .......................................................................................................................................... 1336 postmd(1) .......................................................................................................................................... 1339 postplot(1) ..................................................................................................................................... 1342 postprint(1) ................................................................................................................................... 1344 postreverse(1) ............................................................................................................................... 1346 posttek(1) ........................................................................................................................................ 1348 ppgsz(1) ............................................................................................................................................ 1350 ppriv(1) ............................................................................................................................................ 1353 pr(1) .................................................................................................................................................. 1357 praliases(1) ................................................................................................................................... 1361 prctl(1) ............................................................................................................................................ 1362 preap(1) ............................................................................................................................................ 136812 man pages section 1: User Commands September 2010

Contents

prex(1) .............................................................................................................................................. 1370 print(1) ............................................................................................................................................ 1382 printenv(1B) ................................................................................................................................... 1383 printf(1) .......................................................................................................................................... 1384 priocntl(1) ..................................................................................................................................... 1389 proc(1) .............................................................................................................................................. 1400 prof(1) .............................................................................................................................................. 1404 profiles(1) ..................................................................................................................................... 1408 projects(1) ..................................................................................................................................... 1410 ps(1) .................................................................................................................................................. 1412 ps(1B) ................................................................................................................................................ 1422 ptree(1) ............................................................................................................................................ 1425 pvs(1) ................................................................................................................................................ 1427 pwd(1) ................................................................................................................................................ 1430 ranlib(1) .......................................................................................................................................... 1431 rcapstat(1) ..................................................................................................................................... 1432 rcp(1) ................................................................................................................................................ 1436 rdist(1) ............................................................................................................................................ 1440 read(1) .............................................................................................................................................. 1448 readfile(1F) ................................................................................................................................... 1451 readonly(1) ..................................................................................................................................... 1452 refer(1) ............................................................................................................................................ 1454 regcmp(1) .......................................................................................................................................... 1456 regex(1F) ......................................................................................................................................... 1458 reinit(1F) ....................................................................................................................................... 1461 renice(1) .......................................................................................................................................... 1462 reset(1F) ......................................................................................................................................... 1465 rlogin(1) .......................................................................................................................................... 1466 rm(1) .................................................................................................................................................. 1470 rmformat(1) ..................................................................................................................................... 1474 roffbib(1) ........................................................................................................................................ 1480 roles(1) ............................................................................................................................................ 1482 rpcgen(1) .......................................................................................................................................... 1484 rpm2cpio(1) ..................................................................................................................................... 1489 rsh(1) ................................................................................................................................................ 1490 run(1F) .............................................................................................................................................. 149513

Contents

runat(1) ............................................................................................................................................ 1497 rup(1) ................................................................................................................................................ 1500 rup(1C) ............................................................................................................................................. 1501 ruptime(1) ........................................................................................................................................ 1502 rusage(1B) ....................................................................................................................................... 1503 rusers(1) .......................................................................................................................................... 1505 rwho(1) .............................................................................................................................................. 1506 sag(1) ................................................................................................................................................ 1507 sar(1) ................................................................................................................................................ 1509 sccs(1) .............................................................................................................................................. 1514 sccs-admin(1) ................................................................................................................................. 1525 sccs-cdc(1) ..................................................................................................................................... 1530 sccs-comb(1) ................................................................................................................................... 1532 sccs-delta(1) ................................................................................................................................. 1534 sccs-get(1) ..................................................................................................................................... 1537 sccs-help(1) ................................................................................................................................... 1543 sccs-prs(1) ..................................................................................................................................... 1544 sccs-prt(1) ..................................................................................................................................... 1548 sccs-rmdel(1) ................................................................................................................................. 1551 sccs-sact(1) ................................................................................................................................... 1552 sccs-sccsdiff(1) ........................................................................................................................... 1553 sccs-unget(1) ................................................................................................................................. 1554 sccs-val(1) ..................................................................................................................................... 1555 scp(1) ................................................................................................................................................ 1557 script(1) .......................................................................................................................................... 1559 sdiff(1) ............................................................................................................................................ 1560 sed(1) ................................................................................................................................................ 1562 sed(1B) ............................................................................................................................................. 1570 set(1) ................................................................................................................................................ 1576 set(1F) .............................................................................................................................................. 1582 setcolor(1F) ................................................................................................................................... 1584 setfacl(1) ........................................................................................................................................ 1585 setlabel(1) ..................................................................................................................................... 1590 setpgrp(1) ........................................................................................................................................ 1592 sftp(1) .............................................................................................................................................. 1593 sh(1) .................................................................................................................................................. 159714 man pages section 1: User Commands September 2010

Contents

shell(1F) ......................................................................................................................................... 1618 shell_builtins(1) ......................................................................................................................... 1619 shift(1) ............................................................................................................................................ 1623 shutdown(1B) ................................................................................................................................... 1624 size(1) .............................................................................................................................................. 1625 sleep(1) ............................................................................................................................................ 1627 snmpstatus(1) ................................................................................................................................. 1629 soelim(1) .......................................................................................................................................... 1631 sort(1) .............................................................................................................................................. 1632 sortbib(1) ........................................................................................................................................ 1639 sotruss(1) ........................................................................................................................................ 1641 spell(1) ............................................................................................................................................ 1643 spline(1) .......................................................................................................................................... 1645 split(1) ............................................................................................................................................ 1646 srchtxt(1) ........................................................................................................................................ 1648 ssh(1) ................................................................................................................................................ 1651 ssh-add(1) ........................................................................................................................................ 1662 ssh-agent(1) ................................................................................................................................... 1664 ssh-http-proxy-connect(1) ........................................................................................................ 1666 ssh-keygen(1) ................................................................................................................................. 1668 ssh-keyscan(1) ............................................................................................................................... 1672 ssh-socks5-proxy-connect(1) .................................................................................................... 1674 strchg(1) .......................................................................................................................................... 1676 strings(1) ........................................................................................................................................ 1679 strip(1) ............................................................................................................................................ 1681 stty(1) .............................................................................................................................................. 1683 stty(1B) ........................................................................................................................................... 1691 sum(1) ................................................................................................................................................ 1698 sum(1B) ............................................................................................................................................. 1699 suspend(1) ........................................................................................................................................ 1700 svcprop(1) ........................................................................................................................................ 1701 svcs(1) .............................................................................................................................................. 1705 symorder(1) ..................................................................................................................................... 1712 sysV-make(1) ................................................................................................................................... 1713 tabs(1) .............................................................................................................................................. 1720 tail(1) .............................................................................................................................................. 172415

Contents

talk(1) .............................................................................................................................................. 1727 tar(1) ................................................................................................................................................ 1730 tbl(1) ................................................................................................................................................ 1742 tcopy(1) ............................................................................................................................................ 1744 tee(1) ................................................................................................................................................ 1745 telnet(1) .......................................................................................................................................... 1746 test(1) .............................................................................................................................................. 1759 test(1B) ........................................................................................................................................... 1767 test(1F) ............................................................................................................................................ 1769 tftp(1) .............................................................................................................................................. 1771 time(1) .............................................................................................................................................. 1774 times(1) ............................................................................................................................................ 1776 timex(1) ............................................................................................................................................ 1777 tip(1) ................................................................................................................................................ 1779 tnfdump(1) ........................................................................................................................................ 1788 tnfxtract(1) ................................................................................................................................... 1794 touch(1) ............................................................................................................................................ 1796 touch(1B) ......................................................................................................................................... 1800 tplot(1) ............................................................................................................................................ 1801 tput(1) .............................................................................................................................................. 1802 tr(1) .................................................................................................................................................. 1807 tr(1B) ................................................................................................................................................ 1812 trap(1) .............................................................................................................................................. 1813 troff(1) ............................................................................................................................................ 1815 true(1) .............................................................................................................................................. 1818 truss(1) ............................................................................................................................................ 1819 tset(1B) ........................................................................................................................................... 1827 tsort(1) ............................................................................................................................................ 1832 tty(1) ................................................................................................................................................ 1834 type(1) .............................................................................................................................................. 1835 typeset(1) ........................................................................................................................................ 1836 ucblinks(1B) ................................................................................................................................... 1838 ul(1) .................................................................................................................................................. 1839 umask(1) ............................................................................................................................................ 1840 uname(1) ............................................................................................................................................ 1844 unifdef(1) ........................................................................................................................................ 184716 man pages section 1: User Commands September 2010

Contents

uniq(1) .............................................................................................................................................. 1849 units(1) ............................................................................................................................................ 1852 unix2dos(1) ..................................................................................................................................... 1854 uptime(1) .......................................................................................................................................... 1856 users(1B) ......................................................................................................................................... 1857 uucp(1C) ........................................................................................................................................... 1858 uuencode(1C) ................................................................................................................................... 1862 uuglist(1C) ..................................................................................................................................... 1866 uustat(1C) ....................................................................................................................................... 1867 uuto(1C) ........................................................................................................................................... 1871 uux(1C) ............................................................................................................................................. 1874 vacation(1) ..................................................................................................................................... 1878 vc(1) .................................................................................................................................................. 1881 vgrind(1) .......................................................................................................................................... 1884 vi(1) .................................................................................................................................................. 1887 vipw(1B) ........................................................................................................................................... 1898 volcancel(1) ................................................................................................................................... 1899 volcheck(1) ..................................................................................................................................... 1900 volmissing(1) ................................................................................................................................. 1902 volrmmount(1) ................................................................................................................................. 1903 vsig(1F) ............................................................................................................................................ 1905 w(1) .................................................................................................................................................... 1906 wait(1) .............................................................................................................................................. 1908 wc(1) .................................................................................................................................................. 1911 what(1) .............................................................................................................................................. 1913 whatis(1) .......................................................................................................................................... 1915 whereis(1B) ..................................................................................................................................... 1916 which(1) ............................................................................................................................................ 1918 who(1) ................................................................................................................................................ 1919 whoami(1B) ....................................................................................................................................... 1922 whocalls(1) ..................................................................................................................................... 1923 whois(1) ............................................................................................................................................ 1924 write(1) ............................................................................................................................................ 1925 xargs(1) ............................................................................................................................................ 1928 xgettext(1) ..................................................................................................................................... 1933 xstr(1) .............................................................................................................................................. 193517

Contents

yacc(1) .............................................................................................................................................. 1937 yes(1) ................................................................................................................................................ 1940 ypcat(1) ............................................................................................................................................ 1941 ypmatch(1) ........................................................................................................................................ 1942 yppasswd(1) ..................................................................................................................................... 1943 ypwhich(1) ........................................................................................................................................ 1944 zlogin(1) .......................................................................................................................................... 1945 zonename(1) ..................................................................................................................................... 1948

18

man pages section 1: User Commands September 2010

Preface

Both novice users and those familar with the SunOS operating system can use online man pages to obtain information about the system and its features. A man page is intended to answer concisely the question What does it do? The man pages in general comprise a reference manual. They are not intended to be a tutorial.

OverviewThe following contains a brief description of each man page section and the information it references:

Section 1 describes, in alphabetical order, commands available with the operating system. Section 1M describes, in alphabetical order, commands that are used chiefly for system maintenance and administration purposes. Section 2 describes all of the system calls. Most of these calls have one or more error returns. An error condition is indicated by an otherwise impossible returned value. Section 3 describes functions found in various libraries, other than those functions that directly invoke UNIX system primitives, which are described in Section 2. Section 4 outlines the formats of various files. The C structure declarations for the file formats are given where applicable. Section 5 contains miscellaneous documentation such as character-set tables. Section 6 contains available games and demos. Section 7 describes various special files that refer to specific hardware peripherals and device drivers. STREAMS software drivers, modules and the STREAMS-generic set of system calls are also described. Section 9 provides reference information needed to write device drivers in the kernel environment. It describes two device driver interface specifications: the Device Driver Interface (DDI) and the Driver/Kernel Interface (DKI). Section 9E describes the DDI/DKI, DDI-only, and DKI-only entry-point routines a developer can include in a device driver. Section 9F describes the kernel functions available for use by device drivers. Section 9S describes the data structures used by drivers to share information between the driver and the kernel.19

Preface

Below is a generic format for man pages. The man pages of each manual section generally follow this order, but include only needed headings. For example, if there are no bugs to report, there is no BUGS section. See the intro pages for more information and detail about each section, and man(1) for more information about man pages in general. NAME This section gives the names of the commands or functions documented, followed by a brief description of what they do. This section shows the syntax of commands or functions. When a command or file does not exist in the standard path, its full path name is shown. Options and arguments are alphabetized, with single letter arguments first, and options with arguments next, unless a different argument order is required. The following special characters are used in this section: [ ] Brackets. The option or argument enclo