<commit_before>.TH mount.xtreemfs 1 "July 2011" "The XtreemFS Distributed File System" "XtreemFS client"
.SH NAME
mount.xtreemfs \- mounts an XtreemFS volume
.SH SYNOPSIS
\fBmount.xtreemfs [\fIoptions\fB] [pbrpc[g|s]://]\fIdir-host\fR[:\fIport\fR]/\fIvolume mountpoint
.br

.SH DESCRIPTION
.I mount.xtreemfs
mounts the volume \fIvolume\fR registered at the Directory Service \fIdir-host\fR:\fIport\fR to the local directory \fImountpoint\fR. \fImount.xtreemfs\fR is implemented as a FUSE user-level file system driver.

.SH EXAMPLE USAGE
.TP
Mount the volume "MyVolume" (which is registered at the DIR server "remote.dirservice.machine") to the mount point "/mnt":
.TP
.B "mount.xtreemfs remote.dirservice.machine/MyVolume /mnt"

.SH OPTIONS

.TP
Fuse Options:
.TP
.B "-f, --foreground"
Do not fork into background.
.TP
.BI "-o, --fuse_option " option
Passes -o=<\fIoption\fR> to Fuse.

.TP
ACL and extended attributes Support:
.TP
.B "-o xtreemfs_acl"
Enable the correct evaluation of XtreemFS ACLs. (Note that you cannot use the system tools getfattr and setfattr; use
.BR xtfsutil (1)
instead to set and retrieve ACLs.)
.TP
.B "-o user_xattr"
Enable user defined extended attributes.

.TP
General Options:
.TP
.BI "-d, --log-level " EMERG|ALERT|CRIT|ERR|WARNING|NOTICE|INFO|DEBUG
The log level of the XtreemFS client.
.TP
.B "-h, --help"
Print help and exit.
.TP
.BI "-l, --log-file-path " log_file_path
Path to log file.

.TP
Optimizations:
.TP
.BI "--metadata-cache-size " size
Number of entries which will be cached. (Set to 0 to disable the cache.)
.TP
.BI "--metadata-cache-ttl-s " ttl
Time to live after which cached entries will expire.
.TP
.BI "--readdir-chunk-size " size
Number of directory entries which will be fetched from the MRC per readdir request. Do not set this value too high - otherwise the MRC will spent too much time generating the response containing thousands of directory entries. In general, you should not have directories with multiple thousands of entries. If you stick to this, all directory entries are fetched with one request as long as this value is lower than the number of entries.

.TP
Error Handling options:
.TP
.BI "--max-tries " attempts
Maximum number of
.I attempts
to send a request (0 means infinite).
.TP
.BI "--retry-delay " delay
Wait time after a request failed until next attempt (in seconds).
.TP
.BI "--interrupt-signal "signo
Retry of a request is interrupted if this signal is sent (set to 0 to disable it). (In case of Fuse under Linux,
.I signo
is set to 10 (SIGUSR1) and -o intr and -o intr_signal=10 (=SIGUSR1) will be passed to Fuse.)
.TP
.BI "--connect-timeout " connection-timeout
Timeout after which a connection attempt will be retried (in seconds).
.TP
.BI "--request-timeout " timeout
Timeout after which a request will be retried (in seconds).
.TP
.BI "--linger-timeout " linger-time
Time after which idle connections will be closed (in seconds).

.TP
SSL Options:
.TP
.BI "--pem-certificate-file-path " certfile
Path to PEM certificate file (for SSL installations only).
.TP
.BI "--pem-private-key-file-path " file
Path to PEM private key file (for SSL installations only).
.TP
.BI "--pem-private-key-passphrase " pass
Passphrase for PEM private key file (for SSL installations only). If the option is not specified or the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.
.TP
.BI "--pkcs12-file-path " file
Path to PKCS#12 file (for SSL installations only).
.TP
.BI "--pkcs12-passphrase " pass
Passphrase for PKCS#12 file (for SSL installations only). If the option is not specified or the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.

.TP
Grid Support options:
.TP
.B "--grid-ssl "
Explicitily use the XtreemFS Grid-SSL mode. Same as specifying pbrpcg:// in the volume URL.
.TP
.B "--globus-gridmap"
Authorize using globus gridmap file.
.TP
.B "--unicore-gridmap"
Authorize using unicore gridmap file.
.TP
.BI "--gridmap-location " path
Location of the gridmap file. If this option is not set, the default path will be used, depending on the chosen gridmap file:
.RS
Unicore default: /etc/grid-security/d-grid_uudb
Globus default: /etc/grid-security/grid-mapfile
.RE
.TP
.BI "--gridmap-reload-interval-m " interval
Interval (in minutes) after which the gridmap file will be checked for changes and reloaded if necessary. 60 minutes by default.

.SH "SEE ALSO"
.BR lsfs.xtreemfs (1),
.BR mkfs.xtreemfs (1),
.BR rmfs.xtreemfs (1),
.BR umount.xtreemfs (1),
.BR xtfsutil (1)
.BR

.SH "KNOWN ISSUES"
FUSE does not support mmap in connection with direct I/O. In order to get applications running on XtreemFS that rely on mmap, volumes have to be mounted without using the FUSE option
.BR "-o direct_io" .
However, this might lead to inconsistencies if different clients access a file concurrently, as requests might be serviced from the local page cache.

If
.B "-o xtreemfs_acl"
or a gridmap file is used, the Fuse default permissions check will be disabled. In consequence, the Fuse Option "-o default_permissions" will not be sent to Fuse. In these cases, the content of the metadata cache may be spoofed by users although they are not allowed to list the directory or retrieve the stat information of a file.

.SH AVAILABILITY
The mount.xtreemfs command is part of the XtreemFS-client package and is available from \fIhttp://www.xtreemfs.org\fP.
<commit_msg>man: Updated mount.xtreemfs man page to reflect changes of revision 3053.<commit_after>.TH mount.xtreemfs 1 "July 2011" "The XtreemFS Distributed File System" "XtreemFS client"
.SH NAME
mount.xtreemfs \- mounts an XtreemFS volume
.SH SYNOPSIS
\fBmount.xtreemfs [\fIoptions\fB] [pbrpc[g|s]://]\fIdir-host\fR[:\fIport\fR]/\fIvolume mountpoint
.br

.SH DESCRIPTION
.I mount.xtreemfs
mounts the volume \fIvolume\fR registered at the Directory Service \fIdir-host\fR:\fIport\fR to the local directory \fImountpoint\fR. \fImount.xtreemfs\fR is implemented as a FUSE user-level file system driver.

.SH EXAMPLE USAGE
.TP
Mount the volume "MyVolume" (which is registered at the DIR server "remote.dirservice.machine") to the mount point "/mnt":
.TP
.B "mount.xtreemfs remote.dirservice.machine/MyVolume /mnt"

.SH OPTIONS

.TP
Fuse Options:
.TP
.B "-f, --foreground"
Do not fork into background.
.TP
.BI "-o, --fuse_option " option
Passes -o=<\fIoption\fR> to Fuse.

.TP
ACL and extended attributes Support:
.TP
.B "-o xtreemfs_acl"
Enable the correct evaluation of XtreemFS ACLs. (Note that you cannot use the system tools getfattr and setfattr; use
.BR xtfsutil (1)
instead to set and retrieve ACLs.)
.TP
.B "-o user_xattr"
Enable user defined extended attributes.

.TP
General Options:
.TP
.BI "-d, --log-level " EMERG|ALERT|CRIT|ERR|WARNING|NOTICE|INFO|DEBUG
The log level of the XtreemFS client.
.TP
.B "-h, --help"
Print help and exit.
.TP
.BI "-l, --log-file-path " log_file_path
Path to log file.

.TP
Optimizations:
.TP
.BI "--metadata-cache-size " size
Number of entries which will be cached. (Set to 0 to disable the cache.)
.TP
.BI "--metadata-cache-ttl-s " ttl
Time to live after which cached entries will expire.
.TP
.BI "--readdir-chunk-size " size
Number of directory entries which will be fetched from the MRC per readdir request. Do not set this value too high - otherwise the MRC will spent too much time generating the response containing thousands of directory entries. In general, you should not have directories with multiple thousands of entries. If you stick to this, all directory entries are fetched with one request as long as this value is lower than the number of entries.

.TP
Error Handling options:
.TP
.BI "--max-tries " attempts
Maximum number of
.I attempts
to send a request (0 means infinite).
.TP
.BI "--retry-delay " delay
Wait time after a request failed until next attempt (in seconds).
.TP
.BI "--interrupt-signal "signo
Retry of a request is interrupted if this signal is sent (set to 0 to disable it). (In case of Fuse under Linux,
.I signo
is set to 10 (SIGUSR1) and -o intr and -o intr_signal=10 (=SIGUSR1) will be passed to Fuse.)
.TP
.BI "--connect-timeout " connection-timeout
Timeout after which a connection attempt will be retried (in seconds).
.TP
.BI "--request-timeout " timeout
Timeout after which a request will be retried (in seconds).
.TP
.BI "--linger-timeout " linger-time
Time after which idle connections will be closed (in seconds).

.TP
SSL Options:
.TP
.BI "--pem-certificate-file-path " certfile
Path to PEM certificate file (for SSL installations only).
.TP
.BI "--pem-private-key-file-path " file
Path to PEM private key file (for SSL installations only).
.TP
.BI "--pem-private-key-passphrase " <PASSWORD>
Passphrase for PEM private key file (for SSL installations only). If the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.
.TP
.BI "--pkcs12-file-path " file
Path to PKCS#12 file (for SSL installations only).
.TP
.BI "--pkcs12-passphrase " <PASSWORD>
Passphrase for PKCS#12 file (for SSL installations only). If the argument \fIpass\fR is set to "-", the user will be prompted for the passphrase.

.TP
Grid Support options:
.TP
.B "--grid-ssl "
Explicitily use the XtreemFS Grid-SSL mode. Same as specifying pbrpcg:// in the volume URL.
.TP
.B "--globus-gridmap"
Authorize using globus gridmap file.
.TP
.B "--unicore-gridmap"
Authorize using unicore gridmap file.
.TP
.BI "--gridmap-location " path
Location of the gridmap file. If this option is not set, the default path will be used, depending on the chosen gridmap file:
.RS
Unicore default: /etc/grid-security/d-grid_uudb
Globus default: /etc/grid-security/grid-mapfile
.RE
.TP
.BI "--gridmap-reload-interval-m " interval
Interval (in minutes) after which the gridmap file will be checked for changes and reloaded if necessary. 60 minutes by default.

.SH "SEE ALSO"
.BR lsfs.xtreemfs (1),
.BR mkfs.xtreemfs (1),
.BR rmfs.xtreemfs (1),
.BR umount.xtreemfs (1),
.BR xtfsutil (1)
.BR

.SH "KNOWN ISSUES"
FUSE does not support mmap in connection with direct I/O. In order to get applications running on XtreemFS that rely on mmap, volumes have to be mounted without using the FUSE option
.BR "-o direct_io" .
However, this might lead to inconsistencies if different clients access a file concurrently, as requests might be serviced from the local page cache.

If
.B "-o xtreemfs_acl"
or a gridmap file is used, the Fuse default permissions check will be disabled. In consequence, the Fuse Option "-o default_permissions" will not be sent to Fuse. In these cases, the content of the metadata cache may be spoofed by users although they are not allowed to list the directory or retrieve the stat information of a file.

.SH AVAILABILITY
The mount.xtreemfs command is part of the XtreemFS-client package and is available from \fIhttp://www.xtreemfs.org\fP.

{'fraction_non_alphanumeric': 0.09265087004813032, 'fraction_numerical': 0.005923731951129212, 'mean_word_length': 3.8000888494002667, 'pattern_counts': {'":': 2, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '891115', 'n_tokens_mistral': 3525, 'n_tokens_neox': 3405, 'n_words': 1566}