'\" t
.\"     Title: httpfs2
.\"    Author: Michal Suchanek <hramrach@centrum.cz>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/20/2024
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "HTTPFS2" "1" "03/20/2024" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
httpfs2 \- mount a file from a http server into the filesystem
.SH "SYNOPSIS"
.sp
\fBhttpfs2\fR [\fIOPTIONS\fR] \fIURL\fR \fIFUSE\-OPTIONS\fR \fBhttpfs2_ssl\fR [\fIOPTIONS\fR] \fIURL\fR \fIFUSE\-OPTIONS\fR
.SH "DESCRIPTION"
.sp
httpfs2 is a \fBFUSE\fR based filesystem for mounting http or https URLS as files in the filesystem\&. There is no notion of listable directories in http so only a single URL can be mounted\&. The server must be able to send byte ranges\&.
.SH "OPTIONS"
.PP
\fB\-c \fR\fB\fIconsole\fR\fR
.RS 4
Attempt to use the file ior device
\fIconsole\fR
for output after fork\&. The default is
\fI/dev/console\fR\&.
.RE
.PP
\fB\-f\fR
.RS 4
Do not fork, stay in foreground\&.
.RE
.PP
\fB\-t \fR\fB\fItimeout\fR\fR
.RS 4
Use different timeout for connections\&. Default \*(Aq30\(cqs\&.
.RE
.PP
\fB\fIURL\fR\fR
.RS 4
The url should specify the protocol as http or https, and it may specify basic authentication username and password\&. Currently special characters like whitespace are not handled so the URL cannot contain them\&. See a sample URL below:
.sp
.if n \{\
.RS 4
.\}
.nf
http://user:password@server\&.com/dir/file
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\fIFUSE\-OPTIONS\fR\fR
.RS 4
These options are passed to the
\fBFUSE\fR
library\&. At the very least the mount point should be specified\&.
.RE
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Successfully connected to the server
.RE
.PP
\fBother\fR
.RS 4
Failure (url parsing error, server error, FUSE setup error)\&. Some FUSE errors may happen only after the process forks so they will not be returned in exit value\&.
.RE
.SH "BUGS"
.sp
The process can be stopped by typing ^Z on the terminal which may not be desirable under some circumstances\&.
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
Miklos Szeredi <miklos@szeredi\&.hu>
hmb  marionraven at users\&.sourceforge\&.net
Michal Suchanek <hramrach@centrum\&.cz>
.fi
.if n \{\
.RE
.\}
.SH "COPYING"
.sp
Free use of this software is granted under the terms of the GNU General Public License (GPL)\&.
.SH "AUTHOR"
.PP
\fBMichal Suchanek\fR <\&hramrach@centrum\&.cz\&>
.RS 4
Author.
.RE