2009-12-07 Rolf Bjarne Kvinge <RKvinge@novell.com>
[moon.git] / man / sockpol.1
blob8f21f47fcde9572b276ae5f33b4c8fda58c3c52b
1 .\" 
2 .\" sockpol manual page.
3 .\" Copyright (C) 2009 Novell, Inc (http://www.novell.com)
4 .\"
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .TH sockpol "Moonlight 2.0"
10 .SH NAME
11 sockpol \- Socket Policy Server for Moonlight 2+
12 .SH SYNOPSIS
13 .PP
14 .B sockpol --all | --local | --file policy
15 .SH DESCRIPTION
16 The \fIsockpol\fP command is a small socket server that listen, on port
17 943, to Moonlight and Silverlight plugin request for a socket policy 
18 file.
19 .PP
20 This policy file instruct the plugin if it can, or not, use sockets
21 against the current host and what restrictions must be followed. The
22 three major restrictions are the
23 .I host
24 , the 
25 .I ports
26 , already restricted from 4502 to 4534, and the
27 .I protocol
28 which is currently limited to TCP.
29 .SH OPTIONS
30 The following options are available:
31 .TP
32 .I "--all"
33 Allow access to all URI on every port allowed by Moonlight (4502-4534).
34 .TP
35 .I "--local"
36 Allow local access on every port allowed by Moonlight (4502-4534).
37 .TP
38 .I "--file policy"
39 Load the specified policy file and send it to every requester.
40 .SH FILES
41 When a file policy file is specified it must be in the correct XML format
42 required by the plugins.
43 .PP
44 This example will allow any 
45 .I host
46 (domain) to connect using
47 .I protocol
48 TCP
50 .I ports
51 4502 to 4534. This policy is the most lax policy that is possible to use
52 with Moonlight.
54 .nf
55 <?xml version="1.0" encoding="utf-8"?>
56 <access-policy>
57         <cross-domain-access>
58                 <policy>
59                         <allow-from>
60                                 <domain uri="*" />
61                         </allow-from>
62                         <grant-to>
63                                 <socket-resource port="4502-4534" protocol="tcp" />
64                         </grant-to>
65                 </policy>
66         </cross-domain-access>
67 </access-policy>
68 .fi
69 .SH MAILING LISTS
70 Mailing lists are listed at the
71 http://www.mono-project.com/Mailing_Lists
72 .SH WEB SITE
73 http://www.mono-project.com/Moonlight
74 .SH SEE ALSO
75 .PP
76 mono(1)