Difference between revisions of "Command-line arguments (Client)"

From FileZilla Wiki
Jump to navigationJump to search
(Undo revision 10529 by 31.214.139.196 (talk))
Line 6: Line 6:
  
 
  filezilla [<FTP URL>]
 
  filezilla [<FTP URL>]
  filezilla -s
+
filezilla -h, --help
  filezilla -c <site>
+
  filezilla -s, --site-manager
 +
  filezilla -c, --site=<string>
 +
filezilla -l, --logontype=<string>
 +
filezilla --close
 +
filezilla --verbose
 +
filezilla -v, --version
  
 
=== Options ===
 
=== Options ===
Line 20: Line 25:
 
Valid protocols are '''ftp://''' (the default if ommitted), '''ftps://''', '''ftpes://''' and '''sftp://'''
 
Valid protocols are '''ftp://''' (the default if ommitted), '''ftps://''', '''ftpes://''' and '''sftp://'''
 
</blockquote>
 
</blockquote>
 +
 +
*-h, --help
 +
<blockquote>
 +
Shows the help dialog.
 +
</blockquote>
 +
 
*-s, --sitemanager
 
*-s, --sitemanager
 
<blockquote>
 
<blockquote>
Start with Site Manager opened.
+
Start with opened Site Manager.
 +
<br /><br />
 
May not be used together with -c nor with URL parameter.
 
May not be used together with -c nor with URL parameter.
 
</blockquote>
 
</blockquote>
  
*-c, --site
+
*-c, --site=&lt;string&gt;
 
<blockquote>
 
<blockquote>
Connect to the given site from the Site Manager. Site has to be given as complete path, with a slash as separation character. Any slash or backslash that is part of a segment has to be escaped with a backslash.
+
Connect to specified Site Manager site.
Path has to be prefixed with 0 for user defined entries or 1 for default entries.
+
<br /><br />
Site path may not contain double quotation marks.
+
Site name requirements:
 +
<ul>
 +
    <li>Site has to be given as complete path, with a slash as separation character.</li>
 +
    <li>Any slash or backslash that is part of a segment has to be escaped with a backslash.</li>
 +
    <li>Path has to be prefixed with 0 for user defined entries or 1 for default entries.</li>
 +
    <li>Site path may not contain double quotation marks.</li>
 +
</ul> 
 +
 +
 
 +
Example:
 +
<pre>filezilla --site="0/foo/bar/sl\/ash"</pre>
 +
Connects to the user site "sl/ash" in the site directory "foo/bar".
 +
 
  
              Example:  0/foo/bar/sl\/ash  connects to the user site sl/ash in
+
</blockquote>
              the site directory foo/bar
+
 
 +
*-l, --logontype=(ask|interactive)
 +
<blockquote>
 +
Logon type, can only be used together with FTP URL. Argument has to be either 'ask' or 'interactive'.
 +
<br /><br />
 +
FileZilla will ask for any logon information not supplied in the FTP URL before connecting. Useful for custom scripts or shortcuts.
 
</blockquote>
 
</blockquote>
  
Line 39: Line 68:
 
<blockquote>
 
<blockquote>
 
Closes all running instances of FileZilla.
 
Closes all running instances of FileZilla.
 +
</blockquote>
 +
 +
*--verbose
 +
<blockquote>
 +
Verbose log messages from wxWidgets.
 +
</blockquote>
 +
 +
*-v, --version
 +
<blockquote>
 +
Print version information to stdout and exit.
 
</blockquote>
 
</blockquote>
  

Revision as of 00:18, 10 November 2011

These are the command-line arguments for FileZilla Client. The Server command-line arguments can be found under Command-line arguments (Server).

FileZilla Client command-line arguments

Synopsis

filezilla [<FTP URL>]
filezilla -h, --help
filezilla -s, --site-manager
filezilla -c, --site=<string>
filezilla -l, --logontype=<string>
filezilla --close
filezilla --verbose
filezilla -v, --version

Options

  • <FTP URL>

Accepts all URLs of the form

[protocol://][user[:pass]@]host[:port][/path]
eg.  sftp://username:password@server:port

Valid protocols are ftp:// (the default if ommitted), ftps://, ftpes:// and sftp://

  • -h, --help

Shows the help dialog.

  • -s, --sitemanager

Start with opened Site Manager.

May not be used together with -c nor with URL parameter.

  • -c, --site=<string>

Connect to specified Site Manager site.

Site name requirements:

  • Site has to be given as complete path, with a slash as separation character.
  • Any slash or backslash that is part of a segment has to be escaped with a backslash.
  • Path has to be prefixed with 0 for user defined entries or 1 for default entries.
  • Site path may not contain double quotation marks.


Example:

filezilla --site="0/foo/bar/sl\/ash"

Connects to the user site "sl/ash" in the site directory "foo/bar".


  • -l, --logontype=(ask|interactive)

Logon type, can only be used together with FTP URL. Argument has to be either 'ask' or 'interactive'.

FileZilla will ask for any logon information not supplied in the FTP URL before connecting. Useful for custom scripts or shortcuts.

  • --close (Windows only)

Closes all running instances of FileZilla.

  • --verbose

Verbose log messages from wxWidgets.

  • -v, --version

Print version information to stdout and exit.

Example

Cmdline argument example.png

If you want to connect from the command-line to the site named Backup server in the directory foo/bar, the command is:

filezilla -c "0/foo\/bar/Backup server"