vcabort(LM)                     19 June 1992                     vcabort(LM)


 Name

    vcabort - close a filesharing virtual circuit

 Syntax

    vcabort vcnum

 Description

    The vcabort command closes a virtual circuit to a remote machine.
    ``vcnum'' is the number of the filesharing circuit and is obtained from
    the ``vcid'' field of the net status client command display.

    The vcabort command is most frequently used to remove trusted access con-
    nections.  A trusted connection is established when a user on the client
    machine uses the name of the server in a network pathname, for example:

         //machine/path

    The system automatically establishes a trusted connection the first time
    the remote server name is used in such a path.  (The server machine must
    be set up to allow trusted access.)  Such connections remain established
    indefinitely; however, the system closes dormant connections when it runs
    out of free filesharing circuits.  It is often desirable to remove dor-
    mant connections before the resource shortage becomes critical.  Use the
    net status client command to identify dormant connections, then close
    these connections with the vcabort command.  For more information on set-
    ting up the server to allow trusted access, see the XENIX-NET
    Administrator's Guide.


 See also

    net(LM), status(LM) abort(LM)


 Notes

    You must be the super user to use this command.

    Aborting an active virtual circuit may have unpredictable results, such
    as the file corruption of file transfers that are taking place when the
    virtual circuit is aborted.