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

01.01.2013 Views

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-

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-

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!