man pages section 1: User Commands

Part No: 816–5165–16September 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 intellectualproperty 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 followingnotice 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 supplementalregulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicableGovernment contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, CommercialComputer 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 inherentlydangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim anyliability 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 aretrademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARCInternational, 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 andits affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporationand 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.

110417@25097

Contents

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

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

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

3

auto_ef(1) ............................................................................................................................................ 89awk(1) .................................................................................................................................................... 92banner(1) .............................................................................................................................................. 98basename(1) ......................................................................................................................................... 99basename(1B) ..................................................................................................................................... 101bc(1) .................................................................................................................................................... 102bdiff(1) .............................................................................................................................................. 106bfs(1) .................................................................................................................................................. 107biff(1B) ............................................................................................................................................. 111break(1) .............................................................................................................................................. 112cal(1) .................................................................................................................................................. 114calendar(1) ....................................................................................................................................... 115cancel(1) ............................................................................................................................................ 117cat(1) .................................................................................................................................................. 119cc(1B) .................................................................................................................................................. 122cd(1) .................................................................................................................................................... 124cdrw(1) ................................................................................................................................................ 128checknr(1) .......................................................................................................................................... 134chgrp(1) .............................................................................................................................................. 136chkey(1) .............................................................................................................................................. 139chmod(1) .............................................................................................................................................. 141chown(1) .............................................................................................................................................. 159chown(1B) ........................................................................................................................................... 162ckdate(1) ............................................................................................................................................ 163ckgid(1) .............................................................................................................................................. 166ckint(1) .............................................................................................................................................. 168ckitem(1) ............................................................................................................................................ 170ckkeywd(1) .......................................................................................................................................... 173ckpath(1) ............................................................................................................................................ 175ckrange(1) .......................................................................................................................................... 178ckstr(1) .............................................................................................................................................. 181cksum(1) .............................................................................................................................................. 184cktime(1) ............................................................................................................................................ 186ckuid(1) .............................................................................................................................................. 188ckyorn(1) ............................................................................................................................................ 190clear(1) .............................................................................................................................................. 192

Contents

man pages section 1: User Commands • September 20104

cmp(1) .................................................................................................................................................. 193col(1) .................................................................................................................................................. 195comm(1) ................................................................................................................................................ 197command(1) .......................................................................................................................................... 199compress(1) ....................................................................................................................................... 202coproc(1F) ......................................................................................................................................... 205cp(1) .................................................................................................................................................... 209cpio(1) ................................................................................................................................................ 213cpp(1) .................................................................................................................................................. 221cputrack(1) ....................................................................................................................................... 227crle(1) ................................................................................................................................................ 232crontab(1) .......................................................................................................................................... 242crypt(1) .............................................................................................................................................. 247csh(1) .................................................................................................................................................. 248csplit(1) ............................................................................................................................................ 274ct(1C) ................................................................................................................................................. 277ctags(1) .............................................................................................................................................. 279ctrun(1) .............................................................................................................................................. 282ctstat(1) ............................................................................................................................................ 285ctwatch(1) .......................................................................................................................................... 288cu(1C) ................................................................................................................................................. 290cut(1) .................................................................................................................................................. 297date(1) ................................................................................................................................................ 300dc(1) .................................................................................................................................................... 304deallocate(1) ................................................................................................................................... 307deroff(1) ............................................................................................................................................ 309df(1B) .................................................................................................................................................. 310dhcpinfo(1) ....................................................................................................................................... 312diff(1) ................................................................................................................................................ 315diff3(1) .............................................................................................................................................. 319diffmk(1) ............................................................................................................................................ 321digest(1) ............................................................................................................................................ 322dircmp(1) ............................................................................................................................................ 324dis(1) .................................................................................................................................................. 325dispgid(1) .......................................................................................................................................... 327dispuid(1) .......................................................................................................................................... 328

Contents

5

dos2unix(1) ....................................................................................................................................... 329download(1) ....................................................................................................................................... 331dpost(1) .............................................................................................................................................. 333dtappsession(1) ............................................................................................................................... 336du(1) .................................................................................................................................................... 338du(1B) .................................................................................................................................................. 341dump(1) ................................................................................................................................................ 343dumpcs(1) ............................................................................................................................................ 346echo(1) ................................................................................................................................................ 347echo(1B) ............................................................................................................................................. 350echo(1F) .............................................................................................................................................. 351ed(1) .................................................................................................................................................... 352edit(1) ................................................................................................................................................ 366egrep(1) .............................................................................................................................................. 371eject(1) .............................................................................................................................................. 374elfdump(1) .......................................................................................................................................... 377elfsign(1) .......................................................................................................................................... 379enable(1) ............................................................................................................................................ 384encrypt(1) .......................................................................................................................................... 386enhance(1) .......................................................................................................................................... 389env(1) .................................................................................................................................................. 391eqn(1) .................................................................................................................................................. 393error(1) .............................................................................................................................................. 397ex(1) .................................................................................................................................................... 400exec(1) ................................................................................................................................................ 411exit(1) ................................................................................................................................................ 413expand(1) ............................................................................................................................................ 415exportfs(1B) ..................................................................................................................................... 417expr(1) ................................................................................................................................................ 418expr(1B) ............................................................................................................................................. 422exstr(1) .............................................................................................................................................. 425face(1) ................................................................................................................................................ 429factor(1) ............................................................................................................................................ 430fastboot(1B) ..................................................................................................................................... 431fdformat(1) ....................................................................................................................................... 432fgrep(1) .............................................................................................................................................. 436

Contents

man pages section 1: User Commands • September 20106

file(1) ................................................................................................................................................ 439file(1B) ............................................................................................................................................. 442filesync(1) ....................................................................................................................................... 444find(1) ................................................................................................................................................ 452finger(1) ............................................................................................................................................ 460fmlcut(1F) ......................................................................................................................................... 463fmlexpr(1F) ....................................................................................................................................... 465fmlgrep(1F) ....................................................................................................................................... 468fmli(1) ................................................................................................................................................ 470fmt(1) .................................................................................................................................................. 472fmtmsg(1) ............................................................................................................................................ 473fold(1) ................................................................................................................................................ 477from(1B) ............................................................................................................................................. 479ftp(1) .................................................................................................................................................. 480ftpcount(1) ....................................................................................................................................... 495ftpwho(1) ............................................................................................................................................ 496gcore(1) .............................................................................................................................................. 497gencat(1) ............................................................................................................................................ 499geniconvtbl(1) ................................................................................................................................. 502genlayouttbl(1) ............................................................................................................................... 505genmsg(1) ............................................................................................................................................ 521getconf(1) .......................................................................................................................................... 527getfacl(1) .......................................................................................................................................... 534getfrm(1F) ......................................................................................................................................... 538getitems(1F) ..................................................................................................................................... 539getlabel(1) ....................................................................................................................................... 540getopt(1) ............................................................................................................................................ 541getoptcvt(1) ..................................................................................................................................... 543getopts(1) .......................................................................................................................................... 546gettext(1) .......................................................................................................................................... 552gettxt(1) ............................................................................................................................................ 554getzonepath(1) ................................................................................................................................. 556glob(1) ................................................................................................................................................ 557gprof(1) .............................................................................................................................................. 558graph(1) .............................................................................................................................................. 563grep(1) ................................................................................................................................................ 565

Contents

7

groups(1) ............................................................................................................................................ 570groups(1B) ......................................................................................................................................... 571grpck(1B) ........................................................................................................................................... 572hash(1) ................................................................................................................................................ 573head(1) ................................................................................................................................................ 575history(1) .......................................................................................................................................... 577hostid(1) ............................................................................................................................................ 586hostname(1) ....................................................................................................................................... 587iconv(1) .............................................................................................................................................. 588idnconv(1) .......................................................................................................................................... 591indicator(1F) ................................................................................................................................... 596indxbib(1) .......................................................................................................................................... 598install(1B) ....................................................................................................................................... 599ipcrm(1) .............................................................................................................................................. 601ipcs(1) ................................................................................................................................................ 603isainfo(1) .......................................................................................................................................... 607isalist(1) .......................................................................................................................................... 609jobs(1) ................................................................................................................................................ 610join(1) ................................................................................................................................................ 617kbd(1) .................................................................................................................................................. 620kdestroy(1) ....................................................................................................................................... 626keylogin(1) ....................................................................................................................................... 628keylogout(1) ..................................................................................................................................... 630kill(1) ................................................................................................................................................ 631kinit(1) .............................................................................................................................................. 635klist(1) .............................................................................................................................................. 640kmdb(1) ................................................................................................................................................ 642kmfcfg(1) ............................................................................................................................................ 648kpasswd(1) .......................................................................................................................................... 656krb5-config(1) ................................................................................................................................. 657ksh(1) .................................................................................................................................................. 659ktutil(1) ............................................................................................................................................ 710lari(1) ................................................................................................................................................ 712last(1) ................................................................................................................................................ 719lastcomm(1) ....................................................................................................................................... 721ld(1) .................................................................................................................................................... 723

Contents

man pages section 1: User Commands • September 20108

ld(1B) .................................................................................................................................................. 736ldap(1) ................................................................................................................................................ 737ldapdelete(1) ................................................................................................................................... 741ldaplist(1) ....................................................................................................................................... 747ldapmodify(1) ................................................................................................................................... 751ldapmodrdn(1) ................................................................................................................................... 759ldapsearch(1) ................................................................................................................................... 765ldd(1) .................................................................................................................................................. 775ld.so.1(1) .......................................................................................................................................... 780let(1) .................................................................................................................................................. 788lex(1) .................................................................................................................................................. 789limit(1) .............................................................................................................................................. 801line(1) ................................................................................................................................................ 806lint(1B) ............................................................................................................................................. 807list_devices(1) ............................................................................................................................... 809listusers(1) ..................................................................................................................................... 813llc2_autoconfig(1) ......................................................................................................................... 814llc2_config(1) ................................................................................................................................. 815llc2_stats(1) ................................................................................................................................... 817ln(1) .................................................................................................................................................... 825ln(1B) .................................................................................................................................................. 828loadkeys(1) ....................................................................................................................................... 831locale(1) ............................................................................................................................................ 832localedef(1) ..................................................................................................................................... 835logger(1) ............................................................................................................................................ 840logger(1B) ......................................................................................................................................... 842login(1) .............................................................................................................................................. 844logname(1) .......................................................................................................................................... 852logout(1) ............................................................................................................................................ 853look(1) ................................................................................................................................................ 854lookbib(1) .......................................................................................................................................... 855lorder(1) ............................................................................................................................................ 856lp(1) .................................................................................................................................................... 857lpc(1B) ............................................................................................................................................... 865lpq(1B) ............................................................................................................................................... 869lpr(1B) ............................................................................................................................................... 871

Contents

9

lprm(1B) ............................................................................................................................................. 874lpstat(1) ............................................................................................................................................ 876lptest(1B) ......................................................................................................................................... 880ls(1) .................................................................................................................................................... 881ls(1B) .................................................................................................................................................. 892m4(1) .................................................................................................................................................... 895mac(1) .................................................................................................................................................. 901mach(1) ................................................................................................................................................ 903machid(1) ............................................................................................................................................ 904madv.so.1(1) ..................................................................................................................................... 906mail(1) ................................................................................................................................................ 910mail(1B) ............................................................................................................................................. 916mailcompat(1) ................................................................................................................................... 917mailp(1) .............................................................................................................................................. 919mailq(1) .............................................................................................................................................. 921mailstats(1) ..................................................................................................................................... 923mailx(1) .............................................................................................................................................. 925make(1S) .............................................................................................................................................. 950man(1) .................................................................................................................................................. 985mconnect(1) ....................................................................................................................................... 991mcs(1) .................................................................................................................................................. 992mdb(1) .................................................................................................................................................. 994mesg(1) .............................................................................................................................................. 1038message(1F) ..................................................................................................................................... 1039mixerctl(1) ..................................................................................................................................... 1041mkdir(1) ............................................................................................................................................ 1043mkmsgs(1) .......................................................................................................................................... 1045mkstr(1B) ......................................................................................................................................... 1047mktemp(1) .......................................................................................................................................... 1049moe(1) ................................................................................................................................................ 1052more(1) .............................................................................................................................................. 1054mp(1) .................................................................................................................................................. 1061mpss.so.1(1) ................................................................................................................................... 1069msgfmt(1) .......................................................................................................................................... 1072mt(1) .................................................................................................................................................. 1078mv(1) .................................................................................................................................................. 1081

Contents

man pages section 1: User Commands • September 201010

nawk(1) .............................................................................................................................................. 1084nca(1) ................................................................................................................................................ 1105ncab2clf(1) ..................................................................................................................................... 1107ncakmod(1) ........................................................................................................................................ 1109newform(1) ........................................................................................................................................ 1110newgrp(1) .......................................................................................................................................... 1113news(1) .............................................................................................................................................. 1115newtask(1) ........................................................................................................................................ 1116nice(1) .............................................................................................................................................. 1118NIS+(1) .............................................................................................................................................. 1120niscat(1) .......................................................................................................................................... 1135nischgrp(1) ..................................................................................................................................... 1138nischmod(1) ..................................................................................................................................... 1140nischown(1) ..................................................................................................................................... 1143nischttl(1) ..................................................................................................................................... 1145nisdefaults(1) ............................................................................................................................... 1147niserror(1) ..................................................................................................................................... 1150nisgrpadm(1) ................................................................................................................................... 1151nisln(1) ............................................................................................................................................ 1154nisls(1) ............................................................................................................................................ 1156nismatch(1) ..................................................................................................................................... 1158nismkdir(1) ..................................................................................................................................... 1161nisopaccess(1) ............................................................................................................................... 1164nispasswd(1) ................................................................................................................................... 1167nisrm(1) ............................................................................................................................................ 1171nisrmdir(1) ..................................................................................................................................... 1172nistbladm(1) ................................................................................................................................... 1174nistest(1) ........................................................................................................................................ 1180nl(1) .................................................................................................................................................. 1182nm(1) .................................................................................................................................................. 1185nohup(1) ............................................................................................................................................ 1190nroff(1) ............................................................................................................................................ 1194od(1) .................................................................................................................................................. 1197on(1) .................................................................................................................................................. 1204optisa(1) .......................................................................................................................................... 1206pack(1) .............................................................................................................................................. 1207

Contents

11

pagesize(1) ..................................................................................................................................... 1210pargs(1) ............................................................................................................................................ 1211passwd(1) .......................................................................................................................................... 1213paste(1) ............................................................................................................................................ 1221patch(1) ............................................................................................................................................ 1224pathchk(1) ........................................................................................................................................ 1229pathconv(1F) ................................................................................................................................... 1232pax(1) ................................................................................................................................................ 1234perl(1) .............................................................................................................................................. 1266pfexec(1) .......................................................................................................................................... 1273pg(1) .................................................................................................................................................. 1275pgrep(1) ............................................................................................................................................ 1280pkginfo(1) ........................................................................................................................................ 1284pkgmk(1) ............................................................................................................................................ 1286pkgparam(1) ..................................................................................................................................... 1289pkgproto(1) ..................................................................................................................................... 1291pkgtrans(1) ..................................................................................................................................... 1293pktool(1) .......................................................................................................................................... 1297plabel(1) .......................................................................................................................................... 1311plimit(1) .......................................................................................................................................... 1312plot(1B) ........................................................................................................................................... 1314pmap(1) .............................................................................................................................................. 1316postdaisy(1) ................................................................................................................................... 1325postdmd(1) ........................................................................................................................................ 1327postio(1) .......................................................................................................................................... 1329postmd(1) .......................................................................................................................................... 1332postplot(1) ..................................................................................................................................... 1335postprint(1) ................................................................................................................................... 1337postreverse(1) ............................................................................................................................... 1339posttek(1) ........................................................................................................................................ 1341ppgsz(1) ............................................................................................................................................ 1343ppriv(1) ............................................................................................................................................ 1346pr(1) .................................................................................................................................................. 1350praliases(1) ................................................................................................................................... 1354prctl(1) ............................................................................................................................................ 1355preap(1) ............................................................................................................................................ 1361

Contents

man pages section 1: User Commands • September 201012

prex(1) .............................................................................................................................................. 1363print(1) ............................................................................................................................................ 1375printenv(1B) ................................................................................................................................... 1376printf(1) .......................................................................................................................................... 1377priocntl(1) ..................................................................................................................................... 1382proc(1) .............................................................................................................................................. 1393prof(1) .............................................................................................................................................. 1397profiles(1) ..................................................................................................................................... 1401projects(1) ..................................................................................................................................... 1403ps(1) .................................................................................................................................................. 1405ps(1B) ................................................................................................................................................ 1415ptree(1) ............................................................................................................................................ 1418pvs(1) ................................................................................................................................................ 1420pwd(1) ................................................................................................................................................ 1423ranlib(1) .......................................................................................................................................... 1424rcapstat(1) ..................................................................................................................................... 1425rcp(1) ................................................................................................................................................ 1429rdist(1) ............................................................................................................................................ 1433read(1) .............................................................................................................................................. 1441readfile(1F) ................................................................................................................................... 1444readonly(1) ..................................................................................................................................... 1445refer(1) ............................................................................................................................................ 1447regcmp(1) .......................................................................................................................................... 1449regex(1F) ......................................................................................................................................... 1451reinit(1F) ....................................................................................................................................... 1453renice(1) .......................................................................................................................................... 1454reset(1F) ......................................................................................................................................... 1457rlogin(1) .......................................................................................................................................... 1458rm(1) .................................................................................................................................................. 1462rmformat(1) ..................................................................................................................................... 1466roffbib(1) ........................................................................................................................................ 1472roles(1) ............................................................................................................................................ 1474rpcgen(1) .......................................................................................................................................... 1476rpm2cpio(1) ..................................................................................................................................... 1481rsh(1) ................................................................................................................................................ 1482run(1F) .............................................................................................................................................. 1487

Contents

13

runat(1) ............................................................................................................................................ 1489rup(1) ................................................................................................................................................ 1492rup(1C) ............................................................................................................................................. 1493ruptime(1) ........................................................................................................................................ 1494rusage(1B) ....................................................................................................................................... 1495rusers(1) .......................................................................................................................................... 1497rwho(1) .............................................................................................................................................. 1498sag(1) ................................................................................................................................................ 1499sar(1) ................................................................................................................................................ 1501sccs(1) .............................................................................................................................................. 1506sccs-admin(1) ................................................................................................................................. 1517sccs-cdc(1) ..................................................................................................................................... 1522sccs-comb(1) ................................................................................................................................... 1524sccs-delta(1) ................................................................................................................................. 1526sccs-get(1) ..................................................................................................................................... 1529sccs-help(1) ................................................................................................................................... 1535sccs-prs(1) ..................................................................................................................................... 1536sccs-prt(1) ..................................................................................................................................... 1540sccs-rmdel(1) ................................................................................................................................. 1543sccs-sact(1) ................................................................................................................................... 1544sccs-sccsdiff(1) ........................................................................................................................... 1545sccs-unget(1) ................................................................................................................................. 1546sccs-val(1) ..................................................................................................................................... 1547scp(1) ................................................................................................................................................ 1549script(1) .......................................................................................................................................... 1551sdiff(1) ............................................................................................................................................ 1552sed(1) ................................................................................................................................................ 1554sed(1B) ............................................................................................................................................. 1562set(1) ................................................................................................................................................ 1568set(1F) .............................................................................................................................................. 1574setcolor(1F) ................................................................................................................................... 1576setfacl(1) ........................................................................................................................................ 1577setlabel(1) ..................................................................................................................................... 1581setpgrp(1) ........................................................................................................................................ 1583sftp(1) .............................................................................................................................................. 1584sh(1) .................................................................................................................................................. 1588

Contents

man pages section 1: User Commands • September 201014

shell(1F) ......................................................................................................................................... 1609shell_builtins(1) ......................................................................................................................... 1610shift(1) ............................................................................................................................................ 1614shutdown(1B) ................................................................................................................................... 1615size(1) .............................................................................................................................................. 1616sleep(1) ............................................................................................................................................ 1618snmpstatus(1) ................................................................................................................................. 1619soelim(1) .......................................................................................................................................... 1621sort(1) .............................................................................................................................................. 1622sortbib(1) ........................................................................................................................................ 1629sotruss(1) ........................................................................................................................................ 1631spell(1) ............................................................................................................................................ 1633spline(1) .......................................................................................................................................... 1635split(1) ............................................................................................................................................ 1636srchtxt(1) ........................................................................................................................................ 1638ssh(1) ................................................................................................................................................ 1641ssh-add(1) ........................................................................................................................................ 1652ssh-agent(1) ................................................................................................................................... 1654ssh-http-proxy-connect(1) ........................................................................................................ 1656ssh-keygen(1) ................................................................................................................................. 1658ssh-keyscan(1) ............................................................................................................................... 1662ssh-socks5-proxy-connect(1) .................................................................................................... 1664strchg(1) .......................................................................................................................................... 1666strings(1) ........................................................................................................................................ 1669strip(1) ............................................................................................................................................ 1671stty(1) .............................................................................................................................................. 1673stty(1B) ........................................................................................................................................... 1681sum(1) ................................................................................................................................................ 1688sum(1B) ............................................................................................................................................. 1689suspend(1) ........................................................................................................................................ 1690svcprop(1) ........................................................................................................................................ 1691svcs(1) .............................................................................................................................................. 1695symorder(1) ..................................................................................................................................... 1702sysV-make(1) ................................................................................................................................... 1703tabs(1) .............................................................................................................................................. 1710tail(1) .............................................................................................................................................. 1714

Contents

15

talk(1) .............................................................................................................................................. 1717tar(1) ................................................................................................................................................ 1720tbl(1) ................................................................................................................................................ 1732tcopy(1) ............................................................................................................................................ 1734tee(1) ................................................................................................................................................ 1735telnet(1) .......................................................................................................................................... 1736test(1) .............................................................................................................................................. 1749test(1B) ........................................................................................................................................... 1757test(1F) ............................................................................................................................................ 1759tftp(1) .............................................................................................................................................. 1761time(1) .............................................................................................................................................. 1764times(1) ............................................................................................................................................ 1766timex(1) ............................................................................................................................................ 1767tip(1) ................................................................................................................................................ 1769tnfdump(1) ........................................................................................................................................ 1778tnfxtract(1) ................................................................................................................................... 1784touch(1) ............................................................................................................................................ 1786touch(1B) ......................................................................................................................................... 1790tplot(1) ............................................................................................................................................ 1791tput(1) .............................................................................................................................................. 1792tr(1) .................................................................................................................................................. 1797tr(1B) ................................................................................................................................................ 1802trap(1) .............................................................................................................................................. 1803troff(1) ............................................................................................................................................ 1805true(1) .............................................................................................................................................. 1808truss(1) ............................................................................................................................................ 1809tset(1B) ........................................................................................................................................... 1817tsort(1) ............................................................................................................................................ 1822tty(1) ................................................................................................................................................ 1824type(1) .............................................................................................................................................. 1825typeset(1) ........................................................................................................................................ 1826ucblinks(1B) ................................................................................................................................... 1828ul(1) .................................................................................................................................................. 1829umask(1) ............................................................................................................................................ 1830uname(1) ............................................................................................................................................ 1834unifdef(1) ........................................................................................................................................ 1837

Contents

man pages section 1: User Commands • September 201016

uniq(1) .............................................................................................................................................. 1839units(1) ............................................................................................................................................ 1842unix2dos(1) ..................................................................................................................................... 1844uptime(1) .......................................................................................................................................... 1846users(1B) ......................................................................................................................................... 1847uucp(1C) ........................................................................................................................................... 1848uuencode(1C) ................................................................................................................................... 1852uuglist(1C) ..................................................................................................................................... 1856uustat(1C) ....................................................................................................................................... 1857uuto(1C) ........................................................................................................................................... 1861uux(1C) ............................................................................................................................................. 1864vacation(1) ..................................................................................................................................... 1868vc(1) .................................................................................................................................................. 1871vgrind(1) .......................................................................................................................................... 1874vi(1) .................................................................................................................................................. 1877vipw(1B) ........................................................................................................................................... 1888volcancel(1) ................................................................................................................................... 1889volcheck(1) ..................................................................................................................................... 1890volmissing(1) ................................................................................................................................. 1892volrmmount(1) ................................................................................................................................. 1893vsig(1F) ............................................................................................................................................ 1895w(1) .................................................................................................................................................... 1896wait(1) .............................................................................................................................................. 1898wc(1) .................................................................................................................................................. 1901what(1) .............................................................................................................................................. 1903whatis(1) .......................................................................................................................................... 1905whereis(1B) ..................................................................................................................................... 1906which(1) ............................................................................................................................................ 1908who(1) ................................................................................................................................................ 1909whoami(1B) ....................................................................................................................................... 1912whocalls(1) ..................................................................................................................................... 1913whois(1) ............................................................................................................................................ 1914write(1) ............................................................................................................................................ 1915xargs(1) ............................................................................................................................................ 1918xgettext(1) ..................................................................................................................................... 1923xstr(1) .............................................................................................................................................. 1925

Contents

17

yacc(1) .............................................................................................................................................. 1927yes(1) ................................................................................................................................................ 1930ypcat(1) ............................................................................................................................................ 1931ypmatch(1) ........................................................................................................................................ 1932yppasswd(1) ..................................................................................................................................... 1933ypwhich(1) ........................................................................................................................................ 1934zlogin(1) .......................................................................................................................................... 1935zonename(1) ..................................................................................................................................... 1938

Contents

man pages section 1: User Commands • September 201018

Preface

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

OverviewThe following contains a brief description of each man page section and the information itreferences:■ 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 callsare also described.

■ Section 9 provides reference information needed to write device drivers in the kernelenvironment. It describes two device driver interface specifications: the Device DriverInterface (DDI) and the Driver/Kernel Interface (DKI).

■ Section 9E describes the DDI/DKI, DDI-only, and DKI-only entry-point routines adeveloper 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

Below is a generic format for man pages. The man pages of each manual section generallyfollow 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 eachsection, and man(1) for more information about man pages in general.

NAME This section gives the names of the commands or functionsdocumented, followed by a brief description of what theydo.

SYNOPSIS This section shows the syntax of commands or functions.When a command or file does not exist in the standardpath, its full path name is shown. Options and argumentsare alphabetized, with single letter arguments first, andoptions with arguments next, unless a different argumentorder is required.

The following special characters are used in th