env_set_lg_mode.html [plain text]
<!--$Id: env_set_lg_mode.so,v 1.1 2004/12/15 15:46:44 bostic Exp $-->
<!--Copyright (c) 1997,2008 Oracle. All rights reserved.-->
<!--See the file LICENSE for redistribution information.-->
<html>
<head>
<title>Berkeley DB: DbEnv::set_lg_filemode</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<table width="100%"><tr valign=top>
<td>
<b>DbEnv::set_lg_filemode</b>
</td>
<td align=right>
<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a>
<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td>
</tr></table>
<hr size=1 noshade>
<tt>
<b><pre>
#include <db_cxx.h>
<p>
int
DbEnv::set_lg_filemode(int lg_mode);
<p>
int
DbEnv::get_lg_filemode(int *);
</pre></b>
<hr size=1 noshade>
<b>Description: DbEnv::set_lg_filemode</b>
<p>Set the absolute file mode for created log files. This method is
<b>only</b> useful for the rare Berkeley DB application that does not
control its umask value.</p>
<p>Normally, if Berkeley DB applications set their umask appropriately, all
processes in the application suite will have read permission on the log
files created by any process in the application suite. However, if the
Berkeley DB application is a library, a process using the library might set
its umask to a value preventing other processes in the application suite
from reading the log files it creates. In this rare case, the
DbEnv::set_lg_filemode method can be used to set the mode of created
log files to an absolute value.</p>
<p>The database environment's log file mode may also be configured using the
environment's <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file. The syntax of the entry in that
file is a single line with the string "set_lg_filemode", one or more whitespace
characters, and the absolute mode of created log files.
Because the <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file is read when the database environment
is opened, it will silently overrule configuration done before that
time.</p>
<p>The DbEnv::set_lg_filemode method configures a database environment, not only operations
performed using the specified <a href="../api_cxx/env_class.html">DbEnv</a> handle.</p>
<p>The DbEnv::set_lg_filemode method may be called at any time during the life of the
application.</p>
<p>The DbEnv::set_lg_filemode method
either returns a non-zero error value
or throws an exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
</p>
<b>Parameters</b> <br>
<b>lg_filemode</b><ul compact><li>The <b>lg_filemode</b> parameter is the absolute mode of the created
log file.</ul>
<br>
<hr size=1 noshade>
<b>Description: DbEnv::set_lg_filemode</b>
<p>The DbEnv::set_lg_filemode method returns the log file mode.</p>
<p>The DbEnv::set_lg_filemode method may be called at any time during the life of the
application.</p>
<p>The DbEnv::set_lg_filemode method
either returns a non-zero error value
or throws an exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
</p>
<b>Parameters</b> <br>
<b>lg_modep</b><ul compact><li>The DbEnv::set_lg_filemode method returns the
log file mode in <b>lg_modep</b>.</ul>
<br>
<hr size=1 noshade>
<br><b>Class</b>
<a href="../api_cxx/env_class.html">DbEnv</a>, <a href="../api_cxx/logc_class.html">DbLogc</a>, <a href="../api_cxx/lsn_class.html">DbLsn</a>
<br><b>See Also</b>
<a href="../api_cxx/log_list.html">Logging Subsystem and Related Methods</a>
</tt>
<table width="100%"><tr><td><br></td><td align=right>
<a href="../api_cxx/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a>
</td></tr></table>
<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font>
</body>
</html>