1<!--$Id: env_remove.so,v 11.17 2002/08/18 21:17:29 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: berkdb envremove</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><b>berkdb envremove</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>berkdb envremove 23 [-data_dir directory] 24 [-force] 25 [-home directory] 26 [-log_dir directory] 27 [-tmp_dir directory] 28 [-use_environ] 29 [-use_environ_root] 30</pre></b> 31<b>Description(berkdb envremove)</b> 32<p>Remove a Berkeley DB environment.</p> 33<p>The options are as follows:</p> 34<br> 35<b>-data_dir dirname</b><ul compact><li>Specify the environment's data directory, as described in 36<a href="../ref/env/naming.html">Berkeley DB File Naming</a>.</ul> 37<b>-force</b><ul compact><li>If there are processes that have called <b>berkdb env</b> without calling 38<i>env</i> <b>close</b> (that is, there are processes currently using the 39environment), <b>berkdb envremove</b> will fail without further action, unless 40the <b>-force</b> flag is set, in which case <b>berkdb envremove</b> will 41attempt to remove the environment regardless of any processes still 42using it.</ul> 43<b>-home directory</b><ul compact><li>The <b>-home</b> argument is described in 44<a href="../ref/env/naming.html">Berkeley DB File Naming</a>.</ul> 45<b>-log_dir dirname</b><ul compact><li>Specify the environment's log directory, as described in 46<a href="../ref/env/naming.html">Berkeley DB File Naming</a>.</ul> 47<b>-tmp_dir dirname</b><ul compact><li>Specify the environment's tmp directory, as described in 48<a href="../ref/env/naming.html">Berkeley DB File Naming</a>.</ul> 49<b>-use_environ</b><ul compact><li>The Berkeley DB process' environment may be permitted to specify information 50to be used when naming files; see 51<a href="../ref/env/naming.html">Berkeley DB File Naming</a>. 52Because permitting users to specify which files are used can create 53security problems, environment information will be used in file naming 54for all users only if the <b>-use_environ</b> flag is set.</ul> 55<b>-use_environ_root</b><ul compact><li>The Berkeley DB process' environment may be permitted to specify information 56to be used when naming files; see 57<a href="../ref/env/naming.html">Berkeley DB File Naming</a>. 58As permitting users to specify which files are used can create security 59problems, if the <b>-use_environ_root</b> flag is set, environment 60information will be used for file naming only for users with appropriate 61permissions (for example, users with a user-ID of 0 on IEEE/ANSI Std 1003.1 (POSIX) 62systems).</ul> 63<br> 64<p>The <b>berkdb envremove</b> command returns 0 on success, and in the case of error, a Tcl error 65is thrown.</p> 66</tt> 67<table width="100%"><tr><td><br></td><td align=right> 68<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> 69</td></tr></table> 70<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 71</body> 72</html> 73