AT&T UNIX™PC Unix System V Users Manual - tenox
AT&T UNIX™PC Unix System V Users Manual - tenox AT&T UNIX™PC Unix System V Users Manual - tenox
XTf(lM) XTf(lM) NAME xtt - extract and print xt driver packet traces SYNOPSIS xtt [-f) [-o] DESCRIPTION The xtt command is a debugging tool for the xt(7) driver. It performs an XTIOCTRACE ioctl(2) call on its standard input file to turn on tracing and extract the circular packet trace buffer for the attached group of channels. This call will fail if tracing has not been configured in the driver, or the standard input is not attached to an xt(7) channel. The packets are printed on the standard output The optional flags are: -f Causes a "formfeed" character to be put out at the end of the output, for the benefit of page-display programs. -o Turns off further driver tracing. EXIT STATUS Returns 0 upon successful completion, 1 otherwise. NOTE If driver tracing has not been turned on for the terminal session by invoking layers(!) with the -t option, xtt will not generate any output the first time it is executed. SEE ALSO xtd(lM), xts(lM), ioctl(2), layers(5) in the Programmer's Reference Manual. � xt(7) in the System Administrator's Reference Manual . layers(!) in the User's Reference Manual. - 1-
LOCKING ( 2 ) LOCKING ( 2 ) NAME locking - exclusive access to regions of a file SYNOPSIS int locking (filedes, mode, size); int fildes, mode; long size; DESCRIPTION Locking places or removes a lock on a region of a file. The calling process has exclusive access to regions it has locked: another pro cess that attempts to read or write any byte in the locked region sleeps until the lock is removed. Filedes specifies the file to be locked or unlocked; file des is a file descriptor returned by an open, create , pipe, or dup system call. Mode specifies the action: 0 for lock removal; 1 for blocking lock; 2 for checking lock. The region affected begins at the current file offset associated with filedes and is size bytes longs. If size is zero, the region affected ends at the end of the file. A blocking lock differs from a checking lock only when a process tries to lock bytes already locked by another process. A process locked out of a blocking lock goes to sleep until the specified region is free. A process locked out of a checking lock immediately gets an error return from locking . Locking imposes no structure on a UNIX file. A process can arbitrarily lock any unlocked byte and unlock any locked byte. However, creating a large number of noncontiguous locked regions can fill up the lock table and make further locks impossible. A process is said to be deadlocked if it is sleeping until an unlocking which cannot occur until after the deadlocked process itself does some unlocking. Locking , read, and write deliberately fail if proceeding would cause the calling process to be deadlocked. Special files and pipes can be locked, but no input/output is blocked. SEE ALSO creat(2), close(2), dup(2), open(2), read(2), write(2). RETURN VALUE A return value of -1 indicates an error, with the error value in errno. An unsuccessful checking lock sets errno to EA CCES . A system call aborted by an incipient deadlock or by a lock table overflow sets errno to EDEADLOCK. WARNING Do not apply any standard input/output library function to a locked file. - 1-
- Page 43 and 44: CONVERT( I) CONVERT( I) NAME conver
- Page 45 and 46: EQNCHAR(S) EQNCHAR(S) NAME eqnchar
- Page 47 and 48: FX (1) FX(l) NAME fx - filters nrof
- Page 49 and 50: HPU(l) HPU( 1) NAME hplj -filters n
- Page 51 and 52: ISMPX(l) ISMPX(l) NAME ismpx - retu
- Page 53 and 54: JWIN( l) NAME SYNOPSIS jwin jwin -p
- Page 55 and 56: KTUNE(7) nclist npbuf ncall nttyhog
- Page 57 and 58: LAYERS (l) LAYERS (!) NAME layers -
- Page 59 and 60: LAYERS (l) LAYERS (l) SEE ALSO sh(l
- Page 61 and 62: LAYERS (5) LAYERS (5) identical to
- Page 63 and 64: MACREF(l) MACREF( l) NAME macref -
- Page 65 and 66: MAN( l) 478-12 478-18 479 479-12 47
- Page 67 and 68: MAN(S) MAN(S) NAME man - macros for
- Page 69 and 70: MAN(S) MAN(S) The final example is
- Page 71 and 72: MM(1) 475-17 478 478-12 478-18 479
- Page 73 and 74: MM(S) MM(S) NAME mm - the mm macro
- Page 75 and 76: NDX{l) NDX( l) NAME ndx - create a
- Page 77 and 78: NEQN(l) NEQN(l) NAME neqn - format
- Page 79 and 80: NROFF(1) NROFF( 1) NAME nroff - tex
- Page 81 and 82: NROFF (l) NROFF( l) FILES /usrllib/
- Page 83 and 84: NTERM(S) NTERM(S) Em size of an em
- Page 85 and 86: PTX (l) PTX( l) NAME ptx - make per
- Page 87 and 88: SUBJ(l) SUBJ(l) NAME subj -generate
- Page 89 and 90: TBL(1) TBL( 1) Full details of all
- Page 91 and 92: XT(7) JAGENT XT(7) may return the e
- Page 93: XTS(lM} XTS(lM} NAME SYNOPSIS xts [
- Page 99 and 100: PREFACE The AT&T UNIX System V Us e
- Page 101 and 102: Preface ckeckall(lM) This command i
- Page 103 and 104: profiler(lM) pwck(lM) qasurvey(lM)
- Page 105 and 106: nc(7) nsc(7) phone(7) phonedvr(7) p
- Page 107 and 108: cpio(l) ct(l) ctrace(l) cu(l) diD(
- Page 109 and 110: ld(l) lint(l) ls(l) machid(l) mailx
- Page 111 and 112: spell( I) stlogin(l) ststat(l) time
- Page 113 and 114: atan(3f) atan2(3f) atoj(3c) bool(3f
- Page 115 and 116: mclock(3f) min(3f) menu(3t) message
- Page 117 and 118: x25hlnk(3c) x25£pvc(3c) Section 4:
- Page 119 and 120: TABLE OF CONTENTS 1. Comman ds and
- Page 121 and 122: Table of Contents mm o o o o o prin
- Page 123 and 124: Table of Contents fcntl . . file co
- Page 125 and 126: Table of Contents hypot • • •
- Page 127 and 128: ua • utmp 5. Miscellaneous Facili
- Page 129 and 130: PERMUTED INDEX /functions of HP 264
- Page 131 and 132: � \ paste: paste buffer utilities
- Page 133 and 134: stdipc: standard interprocess commu
- Page 135 and 136: file. delta: make a delta (change)
- Page 137 and 138: getenv: return value for environmen
- Page 139 and 140: ldohseek: seek to the optional file
- Page 141 and 142: cpio: format of cpio archive. dir:
- Page 143 and 144: getpw: get name rrom UID. . • set
XTf(lM) XTf(lM)<br />
NAME<br />
xtt - extract and print xt driver packet traces<br />
SYNOPSIS<br />
xtt [-f) [-o]<br />
DESCRIPTION<br />
The xtt command is a debugging tool for the xt(7) driver. It performs an<br />
XTIOCTRACE ioctl(2) call on its standard input file to turn on tracing<br />
and extract the circular packet trace buffer for the attached group of<br />
channels. This call will fail if tracing has not been configured in the<br />
driver, or the standard input is not attached to an xt(7) channel. The<br />
packets are printed on the standard output<br />
The optional flags are:<br />
-f Causes a "formfeed" character to be put out at the end of the<br />
output, for the benefit of page-display programs.<br />
-o Turns off further driver tracing.<br />
EXIT STATUS<br />
Returns 0 upon successful completion, 1 otherwise.<br />
NOTE<br />
If driver tracing has not been turned on for the terminal session by invoking<br />
layers(!) with the -t option, xtt will not generate any output the first<br />
time it is executed.<br />
SEE ALSO<br />
xtd(lM), xts(lM), ioctl(2), layers(5) in the Programmer's Reference<br />
<strong>Manual</strong>. �<br />
xt(7) in the <strong>System</strong> Administrator's Reference <strong>Manual</strong> .<br />
layers(!) in the User's Reference <strong>Manual</strong>.<br />
- 1-