---
name: "ftpmount"
section: "8"
platform: "linux"
package: "ftpfs-utils"
version: "0.6.2-9"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/ftpmount"
---

# ftpmount(8)

mount a FTP filesystem

## NAME

ftpmount — mount a FTP filesystem

## SYNOPSIS

**ftpmount** URL mount-point  \[options\]

## DESCRIPTION

**ftpmount** mounts a FTP ressource as a Linux filesystem. This command only works in Linux, and the kernel must  support the ftpfs filesystem.

Options to **ftpmount** are specified as a space-separated  list of keys and key=value pairs. If  you get mount failures, check your kernel log for errors on  unknown options.

**ftpmount** is a kernel extension. All protocol  handling, including network connection is done in kernel space.  It will log  useful things using the kernel log mechanism.

## URL

The url can be one of this form:  **\[user:pass@\]ftp\_server\[:port\]**. For details, see below.

## OPTIONS

Defaults are in \[\].

- user

  The user to be used for logging on the FTP server. \[anonymous\]

- password

  The password for that user. \[user@ftpfs.sourceforge.net\]

- hostname

  The FTP server.

- port

  The port the server is listening on. \[21\]

- root\_dir

  The directory on the FTP server you want to be mounted.  This     should be specified without the trailing slash (that is  "/home/duru", not " /home/duru/"). \[/\]

- mount\_point

  The local directory you want to mount the FTP server onto.

- own

  Flag to force ownership on all remote files. Useful for FTP servers     that list user IDs instead of user names.

- uid=\<arg\>

  The local user ID you want to be the owner of the mounted tree.

- gid=\<arg\>

  The local group ID you want to own the mounted tree.

- fmask=\<arg\>

  The numeric mode to be ORed on all mounted files.

- dmask=\<arg\>

  The numeric mode to be ORed on all mounted dirs.

- active

  Flag to enable active mode for FTP transfers. Useful if you're       behind some firewall and cannot connect to random ports.

## THE MOUNT WAY

If for some reason you choose not to use ftpmount (you probably installed the    kernel patch and are too lazy to install ftpmount too), here's the way to use    good-ol mount:

mount -n -t ftpfs none mount\_point -o ip=server\_ip \[,user=user\_name\] \[,pass=     password\] \[,port=server\_port\] \[,root= root\_dir\] \[,own\] \[,uid=id\] \[,gid=id\]       \[,fmode=mask\] \[,dmode=mask\] \[,active\]

Please note that you have to provide the server's IP and that the only  way to  enter a password is in clear.

Example: mount -n -t ftpfs none /mnt/ftpfs -o ip=127.0.0.1,user=mali,pass=my\_pass

## HINTS

Use -n mount option! I bet you don't want your user/password information  listed in mtab.

Don't push it! (pushing it = a dozen processes reading on the mount point)

It works best for one process! While concurrent access (under normal  circumstances) shouldn't cause any problem, the output is optimized for one  process reading (the TCP connection is kept alive). So, if you're gonna  watch a movie, you don't want other processes to access the mount point and  kill the throughoutput (trust me!).

## BUGS

DO NEVER STOP the directory listing operation when invoked. It may  happend that ftpfs destroys it's internal cache and you will have to  reconnect explicitely.

## SEE ALSO

**[auto.ftp(8)](/auto.ftp/8.md)**

## AUTHOR

This manual page was written by Eduard Bloch  (blade@debian.org) for the **Debian**  **GNU/Linux** system (but may be used by others).  Permission is  granted to copy, distribute and/or modify this document under the terms of  the GNU Free Documentation License, Version 1.1 or any  later version published by the Free Software Foundation; with no Invariant  Sections, no Front-Cover Texts and no Back-Cover Texts.