test

TotalNET Advanced Server 5.2 Reference Manual

tnld

This command displays the contents of the TAS file service lock file {TNHOME}/tndb/=flock.file in a readable format. Lock entries appear in any of three forms: "brief", "long", and "wide". If entries appear, a single header line appears first, unless you use the -h option. In all of the forms, blank spaces separate the fields in the output lines. If you specify no options, tnld uses the "brief" form to display lock entries. The "brief" output format contains one line per lock entry. Each line contains the following fields:

Inum

The inode number, a decimal string. 

device

A pair of decimal strings--major and minor device numbers--separated with a comma. 

lock state 

One of the following one- to four-character strings: 

C = DOS Compatibility  

DN = Deny None  

DNDR = Deny None and Deny Read  

DNDW = Deny None and Deny Write  

DR = Deny Read  

DRDW = Deny Read and Deny Write  

DW = Deny Write  

DA = Deny All 

number of clients 

A decimal string. 

filename

A UNIX file name path. It appears when you specify the -f or -s options.

The following table shows an example of brief output format:

Inum

device

lock state

number of clients

filename

821

15,48

C

1

lions.doc

815

15,48

DW

2

tigers.doc

807

15,48

DRDW

2

bears.doc

Location

TNHOME/usr/bin

Usage

tnld [-h][-l] [-s] [-w] [-c client] [-f file]
 	[-i inode-number] [-u username]

Options

-h

Suppress the header line. 

-l

Use the long output format. This format includes lock-entry lines followed by client-info lines. Lock-entry lines contain the following order of fields: inode number, device number, lock state, and, if specified, file name. Each field appears as described above in the tnld description. Lock-entry lines begin with up to seven blank spaces. Client-info lines give information about the file service clients that have the corresponding file open. Each client-info line contains four fields, in the following order: process-id number, user name, realm, and service name. When a lock entry contains a process-id number that does not match a current client object, the client-info line only contains the process-id number and the string (no client). Client-info lines begin with at least 27 blank spaces.

process-id number -- A decimal string. 

user name -- A string with the special string (anon) for anonymous connections. 

realm -- One of the following strings: NB, NW, or AT. 

service name -- A string as it would appear in the output of tninfo -f.

-s

Scan for file names. By default, lock information identifies locked files by device and inode numbers, except when the -f option selects the file. The -s option causes tnld to scan file service volumes so it can display the file names of locked files.

-w

Use the wide output format. This format follows the long output format, but it also includes the client name at the end of the client-info lines. The client name, a string, appears in the output of tninfo -f.

-c client

Select entries locked by a specific file service client. Give the client name as it appears in the output of tninfo -f.

-f file

Select entries for the specified file. For a non-directory file, tnld selects entries for that file. For a directory file, tnld selects entries for all files in the selected directory.

-i inode-number

Select entries for the specified inode number. 

-u username

Select entries locked by the specified UNIX user. 

Examples

  1. Use the following command to display the inode number, device number, lock state, and number of clients:


    tnld

    Sample Output:

    Inum

    device

    state

    clients

    229114

    32,1

    DN

    1

  2. Use one of the following commands to display the inode number, device number, lock state, number of clients, and file names:


    tnld -f /home2/tmp/sh.date
 tnld -s

    Sample Output:

    Inum

    device

    state

    clients

    229144

    102,7

    DN

    1

    filename

    /home2/tmp/sh.date

  3. Use the following command to display contents of the file service lock file in long output format with lock-entry lines and without a file name:


    tnld -l

    Sample Output:

    Inum

    device

    state

    Pid

    user

    229144

    102,7

    DN

    9365

    totalnet

    realm

    service

    NB

    spiffy:file

  4. Use the following command to display the file service lock file in long output format with lock-entry lines, and for a file name readodd.notes in the directory /home2/tmp/:


    tnld -l -f /home2/tmp/readodd.notes

    Sample Output:

    Inum

    device

    state

    filename

    298503

    32.1

    DN

    /home2/tmp/readodd.notes

    Pid

    user

    realm

    service

    9365

    totalnet

    NB

    spiffy:file

  5. Use the following command to display the file service lock file in long output format with client-info lines for the file service client marcie:


    tnld -l -c `N(marcie<00>/1/0)1901' marcie

    Sample Output:

    Inum

    device

    state

    Pid

    user

    229144

    32,1

    DN

    9467

    totalnet

    realm

    service

    NB

    plural:file

  6. Use the following command to display the file service lock file in wide output format with client-info lines:


    tnld -w

    Sample Output:

    Inum

    device

    state

    Pid

    user

    realm

    229144

    32,1

    DN

    9467

    totalnet

    NB

    service

    client

    plural:file

    N(marcie<00>/1/0)1901