Personal tools
You are here: Home FAQ Howto... Work with the official repository
Document Actions

Work with the official repository

This How-to applies to: Any version.

The stable branch is 'master' in the official git repository

Purpose

If you want to run zfs-fuse on a system that has no exisiting packages for zfs-fuse, or you want to run a debug version to support an issue report, you'll need to have access to the source. This howto tells you how you can get started

Prerequisities

You need a system with GIT (The Stupid Content Tracker). This is a revision control method, as such it is comparable to Subversion, which has been used by many projects in the past. Of course git is superior, but that is not the point here.

On many systems, git can be installed by doing

apt-get install git-core

or

yum -i git

Step by step

If you want to get the master branch, all you have to do is simply clone the repository, like so:

cd ~/somedir
git clone http://git.zfs-fuse.net/official

Make sure you are on a mountpoint with the exec flag (not mounted -o noexec) because this is necesarry for parts of the build procedure. You could always temporarily

mount -o remount,exec $mountpoint

Further information

You can get started using git by exploring the basic commands:

  • Inspecting history and commits
git log --oneline
git log
git log master..testing
git log master..testing --oneline --left-right --graph
  •  Reviewing contents of patches
git diff master..testing | kompare -o -
git log -p 1529820b05a
git checkout testing
git checkout -b mynewbranch 238b123eaf8
git clean -dfx
git reset
  •  Updating from origin
git pull origin

See the various good online tutorials for more information.

Git-magic is recommended reading