1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>env dbrename</title> 7 <link rel="stylesheet" href="apiReference.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB TCL API Reference" /> 10 <link rel="up" href="tclapi.html" title="Chapter��1.�� Berkeley DB Tcl APIs" /> 11 <link rel="prev" href="env_dbremove.html" title="env dbremove" /> 12 <link rel="next" href="env_open.html" title="berkdb env" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center"><span class="emphasis"><em>env</em></span> dbrename</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="env_dbremove.html">Prev</a>��</td> 22 <th width="60%" align="center">Chapter��1.�� 23 Berkeley DB Tcl APIs 24 </th> 25 <td width="20%" align="right">��<a accesskey="n" href="env_open.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="sect1" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title" style="clear: both"><a id="env_dbrename"></a><span class="emphasis"><em>env</em></span> dbrename</h2> 35 </div> 36 </div> 37 </div> 38 <pre class="programlisting">env dbrename 39 [-auto_commit] 40 [-txn txnid] 41 [--] 42 file 43 newname </pre> 44 <p> 45 Rename the Berkeley DB database <span class="bold"><strong>file</strong></span> 46 to <span class="bold"><strong>newname</strong></span>. 47 </p> 48 <p> 49 The options are as follows: 50 </p> 51 <div class="itemizedlist"> 52 <ul type="disc"> 53 <li> 54 <p> 55 <span class="bold"><strong>-auto_commit</strong></span> 56 </p> 57 <p> 58 Enclose the call within an implicit transaction (you do not need 59 to provide a transaction handle as a transaction is internally 60 created and commited for you). If the call succeeds, changes 61 made by the operation will be recoverable. If the call fails, the 62 operation will have made no changes. 63 </p> 64 </li> 65 <li> 66 <p> 67 <span class="bold"><strong>-txn txnid</strong></span> 68 </p> 69 <p> 70 If the operation is part of an application-specified transaction, the 71 <span class="bold"><strong>txnid</strong></span> parameter is a transaction 72 handle returned from <span class="emphasis"><em>env</em></span> <span class="bold"><strong>txn</strong></span>. If no transaction handle is specified, 73 but the -auto_commit flag is specified, the operation will be 74 implicitly transaction protected. 75 </p> 76 </li> 77 </ul> 78 </div> 79 <p> 80 The <span class="emphasis"><em>env</em></span> <span class="bold"><strong>dbrename</strong></span> 81 command returns 0 on success, and in the case of error, a Tcl error is 82 thrown. 83 </p> 84 </div> 85 <div class="navfooter"> 86 <hr /> 87 <table width="100%" summary="Navigation footer"> 88 <tr> 89 <td width="40%" align="left"><a accesskey="p" href="env_dbremove.html">Prev</a>��</td> 90 <td width="20%" align="center"> 91 <a accesskey="u" href="tclapi.html">Up</a> 92 </td> 93 <td width="40%" align="right">��<a accesskey="n" href="env_open.html">Next</a></td> 94 </tr> 95 <tr> 96 <td width="40%" align="left" valign="top"><span class="emphasis"><em>env</em></span> dbremove��</td> 97 <td width="20%" align="center"> 98 <a accesskey="h" href="index.html">Home</a> 99 </td> 100 <td width="40%" align="right" valign="top">��berkdb env</td> 101 </tr> 102 </table> 103 </div> 104 </body> 105</html> 106