Merge branch 'upstream' into debian
[shibboleth/sp.git] / debian / man-pages / resolvertest.pod
1 =head1 NAME
2
3 resolvertest - Test Shibboleth SP attribute resolver
4
5 =head1 SYNOPSIS
6
7 B<resolvertest> B<-n> I<name> B<-i> I<idp> B<-p> I<protocol>
8     [B<-f> I<format-uri>] [B<-a> I<app>]
9
10 B<resolvertest> [B<-a> I<app>] < I<assertion>
11
12 =head1 DESCRIPTION
13
14 B<resolvertest> queries the Shibboleth SP attribute resolver and can be
15 used to test attribute release policies and related configuration for a
16 Shibboleth SP.  Either a name, IdP, and protocol may be specified on the
17 command-line or B<resolvertest> can take an assertion in XML on standard
18 input.
19
20 =head1 OPTIONS
21
22 =over 4
23
24 =item B<-a> I<app>
25
26 The application ID.  If not given, the default is C<default>.
27
28 =item B<-i> I<idp>
29
30 The Identity Provider to query for attributes.
31
32 =item B<-f> I<format-uri>
33
34 The URI for the attribute format.
35
36 =item B<-n> I<name>
37
38 The name to look up.
39
40 =item B<-p> I<protocol>
41
42 The protocol to use.  Normally, one of the B<-saml10>, B<-saml11>, or
43 B<-saml2> options should be used to specify the protocol, but B<-p> can be
44 used to specify an arbitrary protocol.
45
46 =item B<-saml10>
47
48 Use the SAML 1.0 protocol.
49
50 =item B<-saml11>
51
52 Use the SAML 1.1 protocol.
53
54 =item B<-saml2>
55
56 Use the SAML 2 protocol.
57
58 =back
59
60 =head1 AUTHOR
61
62 This manual page was written by Russ Allbery for Debian GNU/Linux.
63
64 =head1 COPYRIGHT
65
66 Copyright 2008 Russ Allbery.  This manual page is hereby placed into the
67 public domain by its author.
68
69 =cut