File: urlencode.1

package info (click to toggle)
gridsite 3.0.0~20240125git1200598-1.1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,820 kB
  • sloc: ansic: 16,198; perl: 1,183; makefile: 463; sh: 372; xml: 252
file content (43 lines) | stat: -rw-r--r-- 1,382 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
.TH URLENCODE 1 "November 2003" "urlencode" "GridSite Manual"
.SH NAME
.B urlencode
\- convert strings to or from URL-encoded form
.SH SYNOPSIS
.B urlencode 
[-m|-d] 
.I string [string ...]
.SH DESCRIPTION
.B urlencode
encodes strings according to RFC 1738. 

That is, characters A-Z a-z 0-9 . _ 
and - are passed through unmodified, but all other characters are
represented as %HH, where HH is their two-digit upper-case hexadecimal ASCII
representation.
For example, the URL http://www.gridpp.ac.uk/ becomes
http%3A%2F%2Fwww.gridpp.ac.uk%2F

.B urlencode
converts each character in all the strings given on the command line. If
multiple strings are given, they are concatenated with separating spaces
before conversion.

.SH OPTIONS
.IP "-m"
Instead of full conversion, do GridSite "mild URL encoding" in which A-Z a-z
0-9 . = - _ @ and / are passed through unmodified. This results in slightly
more human-readable strings but the application must be prepared to create
or simulate the directories implied by any slashes.

.IP "-d"
Do URL-decoding rather than encoding, according to RFC 1738. %HH and %hh
strings are converted and other characters are passed through unmodified,
with the exception that + is converted to space.

.SH EXIT CODES
0 is always returned.

.SH AUTHOR
Andrew McNab <Andrew.McNab@manchester.ac.uk>

urlencode is part of GridSite: http://www.gridsite.org/