1<!--$Id: env_set_lg_mode.so,v 1.1 2004/12/15 15:46:44 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB: DB_ENV->set_lg_filemode</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td> 13<b>DB_ENV->set_lg_filemode</b> 14</td> 15<td align=right> 16<a href="../api_c/api_core.html"><img src="../images/api.gif" alt="API"></a> 17<a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a></td> 18</tr></table> 19<hr size=1 noshade> 20<tt> 21<b><pre> 22#include <db.h> 23<p> 24int 25DB_ENV->set_lg_filemode(DB_ENV *dbenv, int lg_mode); 26<p> 27int 28DB_ENV->get_lg_filemode(DB_ENV *dbenv, int *lg_modep); 29</pre></b> 30<hr size=1 noshade> 31<b>Description: DB_ENV->set_lg_filemode</b> 32<p>Set the absolute file mode for created log files. This method is 33<b>only</b> useful for the rare Berkeley DB application that does not 34control its umask value.</p> 35<p>Normally, if Berkeley DB applications set their umask appropriately, all 36processes in the application suite will have read permission on the log 37files created by any process in the application suite. However, if the 38Berkeley DB application is a library, a process using the library might set 39its umask to a value preventing other processes in the application suite 40from reading the log files it creates. In this rare case, the 41DB_ENV->set_lg_filemode method can be used to set the mode of created 42log files to an absolute value.</p> 43<p>The database environment's log file mode may also be configured using the 44environment's <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file. The syntax of the entry in that 45file is a single line with the string "set_lg_filemode", one or more whitespace 46characters, and the absolute mode of created log files. 47Because the <a href="../ref/env/db_config.html#DB_CONFIG">DB_CONFIG</a> file is read when the database environment 48is opened, it will silently overrule configuration done before that 49time.</p> 50<p>The DB_ENV->set_lg_filemode method configures a database environment, not only operations 51performed using the specified <a href="../api_c/env_class.html">DB_ENV</a> handle.</p> 52<p>The DB_ENV->set_lg_filemode method may be called at any time during the life of the 53application.</p> 54<p>The DB_ENV->set_lg_filemode method 55returns a non-zero error value on failure 56and 0 on success. 57</p> 58<b>Parameters</b> <br> 59 <b>lg_filemode</b><ul compact><li>The <b>lg_filemode</b> parameter is the absolute mode of the created 60log file.</ul> 61<br> 62<hr size=1 noshade> 63<b>Description: DB_ENV->set_lg_filemode</b> 64<p>The DB_ENV->set_lg_filemode method returns the log file mode.</p> 65<p>The DB_ENV->set_lg_filemode method may be called at any time during the life of the 66application.</p> 67<p>The DB_ENV->set_lg_filemode method 68returns a non-zero error value on failure 69and 0 on success. 70</p> 71<b>Parameters</b> <br> 72 <b>lg_modep</b><ul compact><li>The DB_ENV->set_lg_filemode method returns the 73log file mode in <b>lg_modep</b>.</ul> 74<br> 75<hr size=1 noshade> 76<br><b>Class</b> 77<a href="../api_c/env_class.html">DB_ENV</a>, <a href="../api_c/logc_class.html">DB_LOGC</a>, <a href="../api_c/lsn_class.html">DB_LSN</a> 78<br><b>See Also</b> 79<a href="../api_c/log_list.html">Logging Subsystem and Related Methods</a> 80</tt> 81<table width="100%"><tr><td><br></td><td align=right> 82<a href="../api_c/api_core.html"><img src="../images/api.gif" alt="API"></a><a href="../ref/toc.html"><img src="../images/ref.gif" alt="Ref"></a> 83</td></tr></table> 84<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 85</body> 86</html> 87