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>berkdb dbremove</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="db_put.html" title="db put" /> 12 <link rel="next" href="db_rename.html" title="berkdb dbrename" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">berkdb dbremove</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="db_put.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="db_rename.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="db_remove"></a>berkdb dbremove</h2> 35 </div> 36 </div> 37 </div> 38 <pre class="programlisting">berkdb dbremove 39 [-encrypt] 40 [-encryptaes passwd] 41 [-encryptany passwd] 42 [-env env] 43 [--] 44 file 45 [database] </pre> 46 <p> 47 Remove the Berkeley DB database specified by the database name 48 <span class="bold"><strong>file</strong></span> and [database] name arguments. 49 If no <span class="bold"><strong>database</strong></span> is specified, the 50 physical file represented by <span class="bold"><strong>file</strong></span> is 51 removed, incidentally removing all databases that it contained. 52 </p> 53 <p> 54 No reference count of database use is maintained by Berkeley DB. 55 Applications should not remove databases that are currently in use. 56 </p> 57 <p> 58 The options are as follows: 59 </p> 60 <div class="itemizedlist"> 61 <ul type="disc"> 62 <li> 63 <p> 64 <span class="bold"><strong>-encrypt</strong></span> 65 </p> 66 <p> 67 Specify the database in an environment is encrypted with the same 68 password that is being used in the environment. 69 </p> 70 </li> 71 <li> 72 <p> 73 <span class="bold"><strong>-encryptaes passwd</strong></span> 74 </p> 75 <p> 76 Specify the database is encrypted with the given password using the 77 Rijndael/AES (also known as the Advanced Encryption Standard and 78 Federal Information Processing Standard (FIPS) 197) algorithm. 79 </p> 80 </li> 81 <li> 82 <p> 83 <span class="bold"><strong>-encryptany passwd</strong></span> 84 </p> 85 <p> 86 Specify the already existing database is encrypted with the given 87 password. This option is used if the database is known to be 88 encrypted, but the specific algorithm used is not known. 89 </p> 90 </li> 91 <li> 92 <p> 93 <span class="bold"><strong>-env env</strong></span> 94 </p> 95 <p> 96 If a <span class="bold"><strong>-env</strong></span> argument is given, the 97 database in the specified Berkeley DB environment is removed. 98 </p> 99 </li> 100 <li> 101 <p> 102 <span class="bold"><strong>--</strong></span> 103 </p> 104 <p> 105 Mark the end of the command arguments. 106 </p> 107 </li> 108 </ul> 109 </div> 110 <p> 111 The <span class="bold"><strong>berkdb dbremove</strong></span> command returns 0 112 on success, and in the case of error, a Tcl error is thrown. 113 </p> 114 </div> 115 <div class="navfooter"> 116 <hr /> 117 <table width="100%" summary="Navigation footer"> 118 <tr> 119 <td width="40%" align="left"><a accesskey="p" href="db_put.html">Prev</a> </td> 120 <td width="20%" align="center"> 121 <a accesskey="u" href="tclapi.html">Up</a> 122 </td> 123 <td width="40%" align="right"> <a accesskey="n" href="db_rename.html">Next</a></td> 124 </tr> 125 <tr> 126 <td width="40%" align="left" valign="top"><span class="emphasis"><em>db</em></span> put </td> 127 <td width="20%" align="center"> 128 <a accesskey="h" href="index.html">Home</a> 129 </td> 130 <td width="40%" align="right" valign="top"> berkdb dbrename</td> 131 </tr> 132 </table> 133 </div> 134 </body> 135</html> 136