Skip to content

Commit

Permalink
man: add man page
Browse files Browse the repository at this point in the history
Closes: #7

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
  • Loading branch information
giuseppe committed Aug 10, 2018
1 parent d40ac75 commit 7e06dcf
Show file tree
Hide file tree
Showing 3 changed files with 97 additions and 0 deletions.
5 changes: 5 additions & 0 deletions Makefile.am
Expand Up @@ -13,6 +13,11 @@ fuse_overlayfs_SOURCES = main.c

WD := $(shell pwd)

man1_MANS = fuse-overlayfs.1

generate-man:
go-md2man -in fuse-overlayfs.1.md -out fuse-overlayfs.1

fuse-overlayfs.spec: $(srcdir)/rpm/fuse-overlayfs.spec.template
sed -e 's|#VERSION#|$(VERSION)|g' < $< > $@

Expand Down
50 changes: 50 additions & 0 deletions fuse-overlayfs.1
@@ -0,0 +1,50 @@
.TH fuse\-overlayfs 1 "User Commands"

.SH NAME
.PP
fuse\-overlayfs \- overlayfs FUSE implementation


.SH SYNOPSIS
.PP
mounting
fuse\-overlayfs [\-f] [\-\-debug] [\-o OPTS] MOUNT\_TARGET

.PP
unmounting
fusermount \-u mountpoint


.SH DESCRIPTION
.PP
fuse\-overlayfs provides an overlayfs FUSE implementation so that it
can be used since Linux 4.18 by unprivileged users in an user
namespace.


.SH OPTIONS
.PP
\fB\-o lowerdir=low1[:low2...]\fP
A list of directories separated by \fB\fC:\fR\&. Their content is merged.

.PP
\fB\-o upperdir=upperdir\fP
A directory merged on top of all the lowerdirs where all the changes
done to the file system will be written.

.PP
\fB\-o workdir=workdir\fP
A directory used internally by fuse\-overlays, must be on the same file
system as the upper dir.


.SH SEE ALSO
.PP
\fBfuse\fP(8), \fBmount\fP(8)


.SH AVAILABILITY
.PP
The slirp4netns command is available from
\fB
\[la]https://github.com/containers/fuse-overlayfs\[ra]\fP under GNU GENERAL PUBLIC LICENSE Version 3 or later.
42 changes: 42 additions & 0 deletions fuse-overlayfs.1.md
@@ -0,0 +1,42 @@
fuse-overlayfs 1 "User Commands"
==================================================

# NAME

fuse-overlayfs - overlayfs FUSE implementation

# SYNOPSIS

mounting
fuse-overlayfs [-f] [--debug] [-o OPTS] MOUNT_TARGET

unmounting
fusermount -u mountpoint

# DESCRIPTION

fuse-overlayfs provides an overlayfs FUSE implementation so that it
can be used since Linux 4.18 by unprivileged users in an user
namespace.

# OPTIONS

**-o lowerdir=low1[:low2...]**
A list of directories separated by `:`. Their content is merged.

**-o upperdir=upperdir**
A directory merged on top of all the lowerdirs where all the changes
done to the file system will be written.

**-o workdir=workdir**
A directory used internally by fuse-overlays, must be on the same file
system as the upper dir.

# SEE ALSO

**fuse**(8), **mount**(8)

# AVAILABILITY

The slirp4netns command is available from
**https://github.com/containers/fuse-overlayfs** under GNU GENERAL PUBLIC LICENSE Version 3 or later.

0 comments on commit 7e06dcf

Please sign in to comment.