1<!--$Id: dbc_dup.so,v 11.8 2002/08/18 21:17:28 bostic Exp $-->
2<!--$Id: m4.tcl,v 11.28 2004/12/16 19:13:05 bostic Exp $-->
3<!--Copyright (c) 1997,2008 Oracle.  All rights reserved.-->
4<!--See the file LICENSE for redistribution information.-->
5<html>
6<head>
7<title>Berkeley DB: db dup</title>
8<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
10</head>
11<body bgcolor=white>
12<table width="100%"><tr valign=top>
13<td>
14<b><i>dbc</i> <b>dup</b></b>
15</td>
16<td align=right>
17<a href="../api_tcl/api_tcl.html"><img src="../images/api.gif" alt="API"></a>
18<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td>
19</tr></table>
20<hr size=1 noshade>
21<tt>
22<b><pre>dbc dup
23	[-position]
24</pre></b>
25<b>Description(db dup)</b>
26<p>The <i>dbc</i> <b>dup</b> command duplicates the cursor, creates a new cursor
27that uses the same transaction and locker ID as the original cursor. This
28is useful when an application is using locking and requires two or more
29cursors in the same thread of control.</p>
30<p>The options are as follows:</p>
31<br>
32<b>-position</b><ul compact><li>The newly created cursor is initialized to refer to the same position
33in the database as the original cursor and hold the same locks. If the
34<b>-position</b> flag is not specified, the created cursor is
35uninitialized and will behave like a cursor newly created using the
36<i>db</i> <b>cursor</b> command.</ul>
37<br>
38<p>The <i>dbc</i> <b>dup</b> command returns 0 on success, and in the case of error, a Tcl error
39is thrown.</p>
40</tt>
41<table width="100%"><tr><td><br></td><td align=right>
42<a href="../api_tcl/api_tcl.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a>
43</td></tr></table>
44<p><font size=1>Copyright (c) 1996,2008 Oracle.  All rights reserved.</font>
45</body>
46</html>
47