source: release-kits/lirk3/resources/gs3-release-maker/ant/docs/manual/OptionalTasks/setproxy.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 8.8 KB
Line 
1
2<html>
3<head>
4 <meta http-equiv="Content-Language" content="en-us">
5 <title>Setproxy
6 Task</title>
7<link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
8</head>
9
10<body bgcolor="#ffffff" text="#000000" link="#525D76"
11 alink="#525D76" vlink="#525D76">
12
13<table border="0" width="100%" cellspacing="4">
14
15 <!-- PAGE HEADER -->
16 <tr>
17 <td>
18 <table border="0" width="100%"><tr>
19 <td valign="bottom">
20 <font size="+3" face="arial,helvetica,sanserif"><strong>Setproxy
21 Task</strong></font>
22 <br><font face="arial,helvetica,sanserif">Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites.</font>
23 </td>
24 <td>
25 <!-- PROJECT LOGO -->
26 <a href="http://ant.apache.org/">
27 <img src="../../images/ant_logo_large.gif" align="right" alt="Apache Ant" border="0"/>
28 </a>
29 </td>
30 </tr></table>
31 </td>
32 </tr>
33
34 <!-- START RIGHT SIDE MAIN BODY -->
35 <tr>
36 <td valign="top" align="left">
37
38 <!-- Applying task/long-description -->
39 <!-- Start Description -->
40 <table border="0" cellspacing="0" cellpadding="2" width="100%">
41 <tr><td>&nbsp;</td></tr>
42
43 <tr><td bgcolor="#525D76">
44 <font color="#ffffff" face="arial,helvetica.sanserif">
45 <a name="description">
46 <strong>Description</strong></a></font>
47 </td></tr>
48
49 <tr><td><blockquote>
50 Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites. You can nominate an http and ftp proxy, or a socks server, reset the server settings, or do nothing at all. <p> Examples <pre>&lt;setproxy/&gt;</pre> do nothing <pre>&lt;setproxy proxyhost="firewall"/&gt;</pre> set the proxy to firewall:80 <pre>&lt;setproxy proxyhost="firewall" proxyport="81"/&gt;</pre> set the proxy to firewall:81 <pre>&lt;setproxy proxyhost=""/&gt;</pre> stop using the http proxy; don't change the socks settings <pre>&lt;setproxy socksproxyhost="socksy"/&gt;</pre> use socks via socksy:1080 <pre>&lt;setproxy socksproxyhost=""/&gt;</pre> stop using the socks server. <p> You can set a username and password for http with the <tt>proxyHost</tt> and <tt>proxyPassword</tt> attributes. On Java1.4 and above these can also be used against SOCKS5 servers. </p>
51 </blockquote></td></tr>
52
53 </table>
54 <!-- End Description -->
55
56 <!-- Ignore -->
57
58
59
60 <!-- Start Attributes -->
61 <table border="0" cellspacing="0" cellpadding="2" width="100%">
62 <tr><td>&nbsp;</td></tr>
63 <tr><td bgcolor="#525D76">
64 <font color="#ffffff" face="arial,helvetica.sanserif">
65 <a name="attributes">
66 <strong>Parameters</strong></a></font>
67 </td></tr>
68 <tr><td><blockquote>
69 <table>
70 <tr>
71 <td bgcolor="#cccccc" valign="top" align="left">
72 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Attribute</b></font>
73 </td>
74 <td bgcolor="#cccccc" valign="top" align="left">
75 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Description</b></font>
76 </td>
77 <td bgcolor="#cccccc" valign="top" align="left">
78 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Type</b></font>
79 </td>
80 <td bgcolor="#cccccc" valign="top" align="left">
81 <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Requirement</b></font>
82 </td>
83 </tr>
84 <!-- Attribute Group -->
85
86 <!-- Attribute Group -->
87 <!-- Attribute -->
88 <tr>
89 <td bgcolor="#eeeeee" valign="top" align="left">
90 <font color="#000000" size="-1" face="arial,helvetica,sanserif">nonproxyhosts</font>
91 </td>
92 <td bgcolor="#eeeeee" valign="top" align="left">
93 <font color="#000000" size="-1" face="arial,helvetica,sanserif">A list of hosts to bypass the proxy on. These should be separated with the vertical bar character '|'. Only in Java 1.4 does ftp use this list. e.g. fozbot.corp.sun.com|*.eng.sun.com</font>
94 </td>
95 <td bgcolor="#eeeeee" valign="top" align="left">
96 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
97 </td>
98 <td bgcolor="#eeeeee" valign="top" align="left" rowspan="7">
99 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Optional</font>
100 </td>
101 </tr>
102 <!-- Attribute -->
103 <tr>
104 <td bgcolor="#eeeeee" valign="top" align="left">
105 <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyhost</font>
106 </td>
107 <td bgcolor="#eeeeee" valign="top" align="left">
108 <font color="#000000" size="-1" face="arial,helvetica,sanserif">the HTTP/ftp proxy host. Set this to "" for the http proxy option to be disabled</font>
109 </td>
110 <td bgcolor="#eeeeee" valign="top" align="left">
111 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
112 </td>
113 </tr>
114 <!-- Attribute -->
115 <tr>
116 <td bgcolor="#eeeeee" valign="top" align="left">
117 <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxypassword</font>
118 </td>
119 <td bgcolor="#eeeeee" valign="top" align="left">
120 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the password for the proxy. Used only if the proxyUser is set.</font>
121 </td>
122 <td bgcolor="#eeeeee" valign="top" align="left">
123 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
124 </td>
125 </tr>
126 <!-- Attribute -->
127 <tr>
128 <td bgcolor="#eeeeee" valign="top" align="left">
129 <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyport</font>
130 </td>
131 <td bgcolor="#eeeeee" valign="top" align="left">
132 <font color="#000000" size="-1" face="arial,helvetica,sanserif">the HTTP/ftp proxy port number; default is 80</font>
133 </td>
134 <td bgcolor="#eeeeee" valign="top" align="left">
135 <font color="#000000" size="-1" face="arial,helvetica,sanserif">int</font>
136 </td>
137 </tr>
138 <!-- Attribute -->
139 <tr>
140 <td bgcolor="#eeeeee" valign="top" align="left">
141 <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyuser</font>
142 </td>
143 <td bgcolor="#eeeeee" valign="top" align="left">
144 <font color="#000000" size="-1" face="arial,helvetica,sanserif">set the proxy user. Probably requires a password to accompany this setting. Default=""</font>
145 </td>
146 <td bgcolor="#eeeeee" valign="top" align="left">
147 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
148 </td>
149 </tr>
150 <!-- Attribute -->
151 <tr>
152 <td bgcolor="#eeeeee" valign="top" align="left">
153 <font color="#000000" size="-1" face="arial,helvetica,sanserif">socksproxyhost</font>
154 </td>
155 <td bgcolor="#eeeeee" valign="top" align="left">
156 <font color="#000000" size="-1" face="arial,helvetica,sanserif">The name of a Socks server. Set to "" to turn socks proxying off.</font>
157 </td>
158 <td bgcolor="#eeeeee" valign="top" align="left">
159 <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
160 </td>
161 </tr>
162 <!-- Attribute -->
163 <tr>
164 <td bgcolor="#eeeeee" valign="top" align="left">
165 <font color="#000000" size="-1" face="arial,helvetica,sanserif">socksproxyport</font>
166 </td>
167 <td bgcolor="#eeeeee" valign="top" align="left">
168 <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the ProxyPort for socks connections. The default value is 1080</font>
169 </td>
170 <td bgcolor="#eeeeee" valign="top" align="left">
171 <font color="#000000" size="-1" face="arial,helvetica,sanserif">int</font>
172 </td>
173 </tr>
174
175
176 </table>
177 </blockquote></td></tr>
178
179 </table>
180 <!-- End Attributes -->
181
182 <!-- Start Elements -->
183 <table border="0" cellspacing="0" cellpadding="2" width="100%">
184 <tr><td>&nbsp;</td></tr>
185
186 <tr><td bgcolor="#525D76">
187 <font color="#ffffff" face="arial,helvetica.sanserif">
188 <a name="elements">
189 <strong>Parameters as nested elements</strong></a></font>
190 </td></tr>
191
192 <tr><td><blockquote>
193
194 </blockquote></td></tr>
195
196 </table>
197 <!-- End Elements -->
198
199
200 </td>
201 </tr>
202 <!-- END RIGHT SIDE MAIN BODY -->
203
204 <!-- FOOTER SEPARATOR -->
205 <tr>
206 <td>
207 <hr noshade="" size="1"/>
208 </td>
209 </tr>
210
211 <!-- PAGE FOOTER -->
212 <tr>
213 <td>
214 <div align="center"><font color="#525D76" size="-1"><em>
215 Copyright &copy; 2000-2004, The Apache Software Foundation. All Rights Reserved.
216 </em></font></div>
217 </td>
218 </tr>
219
220</table>
221
222</body>
223</html>
Note: See TracBrowser for help on using the repository browser.