Name

bif-init - initialize a new bif repository

Version

0.1.5_8 (yyyy-mm-dd)

Synopsis

bif init [DIRECTORY] [LOCATION] [OPTIONS...]

Description

The bif-init command creates a new bif repository - basically a directory containing the following files:

config
A INI-style configuration file.
db.sqlite3
An SQLite database file.

With no arguments this commands creates a working repository in $PWD/.bif. Bif commands search up the filesystem for such a directory to use as their current working repository.

If the DIRECTORY argument is given then a hub repository is created at that path instead. Hub repositories are used to synchronize changes between your current working repository and the working repositories of other people.

During initialization the user's "self" identity is cloned from the user repository, which is automatically created if it does not already exist.

Arguments & Options

DIRECTORY
Path for a new hub repository instead of a working repository.
LOCATION
Publically visible location of the hub repository to publish instead of DIRECTORY. This is typically an ssh address such as ssh://org@hub.host.
--bare, -b
Create a very empty repository. I.e. do not clone the "self" identity or create a hub topic.
--keep-invalid
Set the keep_invalid option in the bifkv table to true. This prevents invalid changes from being rolled back out of the database so they can be inspected. As this option is aimed at developers it is hidden from normal usage messages.

Errors

PathExists
Attempting to initialise an existing repository is considered an error.

Files

$HOME/.bifu/
Default user repository location.

See Also

bif(1)

Author

Mark Lawrence <nomad@null.net>

Copyright And License

Copyright 2013-2017 Mark Lawrence <nomad@null.net>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.