.TH CLONE 5 
.SH NAME
clone \- duplicate a fid
.SH SYNOPSIS
.ta \w'\fLTclone 'u
.B Tclone
.IR tag [2]
.IR fid [2]
.IR newfid [2]
.br
.B Rclone
.IR tag [2]
.IR fid [2]
.SH DESCRIPTION
The \f5clone\fP request carries as arguments an existing \f2fid\fP and a proposed \f2newfid\fP
(which must not be in use)
that the client wishes to associate with
the same file as \f2fid\fP.
The \f2fid\fP must be valid in the current session and must not have been opened for I/O
by an \f5open\fP or \f5create\fP message.
After a successful \f5clone\fP and before any subsequent messages,
\f2fid\fP and \f2newfid\fP are indistinguishable.
.ig
.br
\f(HIsrb\fP: 
What is the definition of \f2session\fP in the absence of \f5[TR]session\fP messages?
.br
\f(HIsrb\fP:  per rob: perhaps s/session/connection?
..
.SH ENTRY POINTS
A \f5clone\fP message is generated by any system call that evaluates a path name and
by a \f5read\fP of a union directory.