.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\" ========================================================================
.\"
.IX Title "mount.posixovl 1"
.TH mount.posixovl 1 "2012-04-03" "mount.posixovl" "User Commands"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
posixovl \-\- FUSE file system that provides POSIX functionality
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    mount.posixovl [\-F] [\-S SOURCE_DIR] TARGET_DIR [\-\- fuseopts]
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
If no source directory is given, the \s-1TARGET_DIR\s0 specifies both source
and target (mount point), yielding an \*(L"over mount\*(R".
.PP
Supports: chmod, chown, hardlink, mkfifo, mknod, symlink/readlink
ACLs/xattrs (only in passthrough mode, no emulation).
.SH "NOTES"
.IX Header "NOTES"
Using posixovl on an already POSIX-behaving file system (e.g. \s-1XFS\s0)
incurs some issues, since detecting whether a path is \s-1POSIX\s0 behaving
or not is difficult. Hence, the following decision was made:
.PP
.Vb 4
\&    \- permissions will be set to the default permissions (see below) unless
\&      a HCB is found that can override these
\&    \- all lower\-level files will be operated on/created with the user who
\&      initiated the mount
.Ve
.PP
If no \s-1HCB\s0 exists for a file or directory, the default permissions are
644 and 755, respectively. The owner and group of the inode will be the
owner/group of the real file.
.PP
Each non-regular, non-directory virtual file will have a zero-size real
file. Simplifies handling, and makes it apparent the object exists
when using other operating system.
.PP
Command \fIdf\fR\|(1) will show:
.PP
.Vb 5
\&    $ df \-Tah
\&    File System    Type    Size  Used Avail Use% Mounted on
\&    /dev/hda5     vfat    5.9G  2.1G  3.9G  35% /windows/D
\&    posix\-overlay(/windows/D)
\&         fuse.posixovl    5.9G  2.1G  3.9G  35% /windows/D
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-F\fR" 4
.IX Item "-F"
Option \fB\-F\fR will disable permission and ownership checks that would
be required in case you have a \s-1POSIX\s0 mount over \s-1VFAT\s0. For example,
where /vfat is vfat, and /vfat/xfs is a POSIX-behaving file system.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
In general, posixovl does not handle case-insensitivity of the
underlying file system (in case of \s-1VFAT\s0, for example). If you create a
file \fIX0\fR on \s-1VFAT\s0, it is usually lowercased to \fIx0\fR, which may break
some software, namely X.org. In order to make \s-1VFAT\s0 behave more
POSIX-like, the following mount options are recommended:
.PP
.Vb 1
\&    mount \-t vfat /dev/sda5 /mnt/vfat \-o check=s,shortname=mixed
.Ve
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
None.
.SH "FILES"
.IX Header "FILES"
None.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fImount\fR\|(1)
\&\fIumount\fR\|(1)
.SH "AUTHORS"
.IX Header "AUTHORS"
Program was written by Jan Engelhardt <jengelh@users.sourceforge.net>.
.PP
This manual page was written by Jari Aalto <jari.aalto@cante.net>, for
the Debian \s-1GNU\s0 system (but may be used by others). Released under
license \s-1GNU\s0 \s-1GPL\s0 version 2 or (at your option) any later version. For
more information about license, visit
<http://www.gnu.org/copyleft/gpl.html>.