monotone-doc 1.0-3 / usr / share / doc / monotone / html / Managed-Databases.html

This file is indexed.

/usr/share/doc/monotone/html/Managed-Databases.html is in monotone-doc 1.0-3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
<html lang="en">
<head>
<title>Managed Databases - monotone documentation</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="monotone documentation">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Advanced-Uses.html#Advanced-Uses" title="Advanced Uses">
<link rel="prev" href="Vars.html#Vars" title="Vars">
<link rel="next" href="Reserved-Files.html#Reserved-Files" title="Reserved Files">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
<link rel="stylesheet" type="text/css" href="texinfo.css">
</head>
<body>
<div class="node">
<a name="Managed-Databases"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Reserved-Files.html#Reserved-Files">Reserved Files</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Vars.html#Vars">Vars</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Advanced-Uses.html#Advanced-Uses">Advanced Uses</a>
<hr>
</div>

<h3 class="section">3.10 Managed Databases</h3>

<p>In monotone commands, a database name (provided to a <samp><span class="option">--db</span></samp>
option) starting with &ldquo;:&rdquo; is a &ldquo;database alias&rdquo;. It addresses
a usual monotone database sitting in a special, &ldquo;managed&rdquo; location,
which we therefore call a &ldquo;managed database&rdquo;.

<p>The database alias is a regular file name (excluding the leading colon). 
Monotone searches for this file name in common locations and internally
expands it to a full path once it found an unambigious match.

<p>Some commands, such as <samp><span class="command"><a href="mtn-clone.html#mtn-clone">mtn clone</a></span></samp> and <samp><span class="command"><a href="mtn-setup.html#mtn-setup">mtn setup</a></span></samp>, work without a <samp><span class="option">--db</span></samp> option; they fall back on a
managed &ldquo;default&rdquo; database and even initialize that in case it is
not existant.

<p>To keep an overview of managed databases and their workspaces, the commands
<samp><span class="command"><a href="mtn-list-databases.html#mtn-list-databases">mtn list databases</a></span></samp> and <samp><span class="command"><a href="mtn-list-workspaces.html#mtn-list-workspaces">mtn list workspaces</a></span></samp>
can be used:  The former shows a list of all known databases in all managed
locations together with their workspaces, while the latter only shows the
list of workspaces for a single, specified database.

<p>Monotone usually keeps track of known workspaces automatically in the
background and updates the references as soon as your workspace' database
option in <samp><span class="file">_MTN/options</span></samp> is set up or changed. There are a few cases
where monotone is unable to detect changes, though, for example when a
workspace is moved in the file system. To get monotone back on track in
cases like this, the commands <samp><span class="command"><a href="mtn-register_005fworkspace.html#mtn-register_005fworkspace">mtn register_workspace</a></span></samp> and
<samp><span class="command"><a href="mtn-unregister_005fworkspace.html#mtn-unregister_005fworkspace">mtn unregister_workspace</a></span></samp> can be used.

<p>Finally, all this magic behaviour can be customized by a variety of
lua hooks:

     <ul>
<li><a href="get_005fdefault_005fdatabase_005flocations.html#get_005fdefault_005fdatabase_005flocations">get_default_database_locations</a> returns a list of search paths
where monotone should look for managed databases. 
This hook defaults to a single directory; <samp><span class="file">$HOME/.monotone/databases</span></samp>
on Unix and <samp><span class="file">%APPDATA%\monotone\databases</span></samp> on Windows.

     <li><a href="get_005fdefault_005fdatabase_005fglob.html#get_005fdefault_005fdatabase_005fglob">get_default_database_glob</a> returns a pattern which monotone uses
to match and recognized database files in the configured default locations. 
This pattern is also used to determine if shortened database aliases, such
as <code>:default</code>, should get suffixed with <code>.mtn</code> to be transformed
into a valid database file name. By default this hook returns <code>.{mtn,db}</code>.

     <li><a href="get_005fdefault_005fdatabase_005falias.html#get_005fdefault_005fdatabase_005falias">get_default_database_alias</a> returns the name of the alias of a
default database that is initialized and used on demand.  If more than one
database locations are configured, the first location is used as save location
for this database. This hook defaults to <code>:default.mtn</code>. 
</ul>

</body></html>

APT Browse - Built by Thomas Orozco.