session_url » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
2013-10-24 | 2013-10-24 | ||
5.2.5 Bug 1062: UTF-8 encoded characters in session URL are supported (martin) | sections (martin) | ||
Line 2: | Line 2: | ||
On [[commandline|command-line]] and in parameter of scripting command ''[[scriptcommand_open|open]]'', you can, in addition to using [[session_configuration#site|site]] (stored session) &beta name, specify an ad-hoc session using URL. | On [[commandline|command-line]] and in parameter of scripting command ''[[scriptcommand_open|open]]'', you can, in addition to using [[session_configuration#site|site]] (stored session) &beta name, specify an ad-hoc session using URL. | ||
- | The syntax is: | + | ===== Syntax ===== |
[ sftp|ftp|ftps|scp :// ][ <username> [ : <password> ] @ ] <host> [ : <port> ] | [ sftp|ftp|ftps|scp :// ][ <username> [ : <password> ] @ ] <host> [ : <port> ] | ||
+ | |||
+ | ===== Elements ===== | ||
The only mandatory part is ''host''. You should also always explicitly specify a protocol (''[[sftp]]'', ''[[ftp]]'' or ''[[scp]]'', the ''[[ftps]]'' protocol is FTP over TLS/SSL). ((Protocol is ''sftp'' by default, but the default can be changed.)) Most URL's will include also ''username''. The ''port'' needs to be specified only, when it differs from the default port for the protocol (22 for ''sftp''/''scp'', 21 for ''ftp'' and 990 for implicit ''ftps''). | The only mandatory part is ''host''. You should also always explicitly specify a protocol (''[[sftp]]'', ''[[ftp]]'' or ''[[scp]]'', the ''[[ftps]]'' protocol is FTP over TLS/SSL). ((Protocol is ''sftp'' by default, but the default can be changed.)) Most URL's will include also ''username''. The ''port'' needs to be specified only, when it differs from the default port for the protocol (22 for ''sftp''/''scp'', 21 for ''ftp'' and 990 for implicit ''ftps''). | ||
The ''host'' can either be a host name (such as ''example.com''), an IPv4 address (such as ''127.0.0.1'') or an IPv6 address surrounded by square brackets (such as ''[2001:db8:85a3:8d3:1319:8a2e:370:7348]''). | The ''host'' can either be a host name (such as ''example.com''), an IPv4 address (such as ''127.0.0.1'') or an IPv6 address surrounded by square brackets (such as ''[2001:db8:85a3:8d3:1319:8a2e:370:7348]''). | ||
+ | |||
+ | ===== Special Characters ===== | ||
Special characters (like ''@'' in username, see example below) have to be encoded using ''%XX'' syntax, where ''XX'' is hexadecimal UTF-8 code.((For multi-byte codes, use ''%'' before every byte, for instance to represent pound-sign ''£'' use ''%C2%A3''.)) | Special characters (like ''@'' in username, see example below) have to be encoded using ''%XX'' syntax, where ''XX'' is hexadecimal UTF-8 code.((For multi-byte codes, use ''%'' before every byte, for instance to represent pound-sign ''£'' use ''%C2%A3''.)) | ||
Line 19: | Line 24: | ||
* ''@'': ''%40'' (at sign) | * ''@'': ''%40'' (at sign) | ||
- | Examples: | + | ===== Examples ===== |
sftp://martin:mypassword@example.com | sftp://martin:mypassword@example.com | ||
martin%40example.com:4pRte!ai%253@example.com | martin%40example.com:4pRte!ai%253@example.com |