summaryrefslogtreecommitdiff
path: root/doc/manpages/gnutls-serv.1
blob: a70b8d53ded2c62ebe6999eba9fe72f9a41d45dd (plain)
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.TH gnutls\-serv 1 "December 1st 2003"
.SH NAME
gnutls\-serv \- GnuTLS test server
.SH SYNOPSIS
gnutls\-serv [\fIoptions\fR]
.SH DESCRIPTION
Simple server program that listens to incoming TLS connections.
.SH OPTIONS
.SS Program control options
.IP "\-d, \-\-debug LEVEL"
Specify the debug level. Default is 1.
.IP "\-h, \-\-help"
prints this help
.IP "\-l, \-\-list"
Print a list of the supported algorithms and modes.
.IP "\-q, \-\-quiet"
Suppress some messages.
.IP "\-v, \-\-version"
prints the program's version number

.SS Server options
.IP "\-p, \-\-port \fIinteger\fR"
The port to listen on.
.IP "\-\-nodb"
Does not use the resume database.
.IP "\-\-http"
Act as an HTTP Server.
.IP "\-\-echo"
Act as an Echo Server.

.SS TLS/SSL control options
.IP "\-\-priority \fIPRIORITY STRING\fR"
TLS algorithms and protocols to enable.
Unless the first keyword is "NONE" the defaults are:
.IP 
Protocols: TLS1.1, TLS1.0, and SSL3.0.
.IP 
Compression: NULL.
.IP 
Certificate types: X.509, OpenPGP.
.IP
You can also use predefined sets of ciphersuites such as: 
.IP
.B "PERFORMANCE"
all the "secure" ciphersuites are enabled, limited to 128 bit
ciphers and sorted by terms of speed performance.
.IP 
.B "NORMAL" 
option enables all "secure" ciphersuites. The 256-bit ciphers
are included as a fallback only. The ciphers are sorted by security
margin.
.IP 
.B "SECURE128" 
flag enables all "secure" ciphersuites with ciphers up to
128 bits, sorted by security margin.
.IP 
.B "SECURE256" 
flag enables all "secure" ciphersuites including the 256 bit
ciphers, sorted by security margin.
.IP 
.B "EXPORT" 
all the ciphersuites are enabled, including the
low-security 40 bit ciphers.
.IP 
.B "NONE" 
nothing is enabled. This disables even protocols and
compression methods.
.IP
.IP 
Special keywords:
.IP
"!" or "-" appended with an algorithm will remove this algorithm.
.IP
"+" appended with an algorithm will add this algorithm.
.IP
"%COMPAT" will enable compatibility features for a server.
.IP
"%UNSAFE_RENEGOTIATION" will enable unsafe renegotiation (default).
.IP
"%SAFE_RENEGOTIATION" will enable safe renegotiation.
.IP
"%INITIAL_SAFE_RENEGOTIATION" will force initial safe negotiation even if
renegotiation wasn't requested.
.IP
To avoid collisions in order to specify a compression algorithm in
this string you have to prefix it with "COMP-", protocol versions
with "VERS-" and certificate types with "CTYPE-". All other
algorithms don't need a prefix.
.IP 
.B Examples:
.IP 
"NORMAL"
.IP 
"NORMAL:%COMPAT"
.IP 
"NORMAL:!AES-128-CBC"
.IP 
"NONE:+VERS-TLS1.0:+AES-128-CBC:+RSA:+SHA1:+COMP-NULL"

.IP "\-g, \-\-generate"
Generate Diffie-Hellman Parameters.
.IP "\-\-kx \fIkx1 kx2...\fR"
Key exchange methods to enable (use \fBgnutls\-cli \-\-list\fR to show
the supported key exchange methods).
.IP "\-p, \-\-port \fIinteger\fR"
The port to connect to.

.SS Certificate options
.IP "\-\-pgpcertfile \fIFILE\fR"
PGP Public Key (certificate) file to use.
.IP "\-\-pgpkeyfile \fIFILE\fR"
PGP Key file to use.
.IP "\-\-pgpkeyring \fIFILE\fR"
PGP Key ring file to use.
.IP "\-\-pgptrustdb \fIFILE\fR"
PGP trustdb file to use.
.IP "\-\-srppasswd \fIFILE\fR"
SRP password file to use.
.IP "\-\-srppasswdconf \fIFILE\fR"
SRP password configuration file to use.
.IP "\-\-x509cafile \fIFILE\fR"
Certificate file to use.
.IP "\-\-x509certfile \fIFILE\fR"
X.509 Certificate file to use.
.IP "\-\-x509fmtder"
Use DER format for certificates
.IP "\-\-x509keyfile \fIFILE\fR"
X.509 key file to use.

.SH "SEE ALSO"
.BR gnutls\-cli (1),
.BR gnutls\-cli\-debug (1)
.SH AUTHOR
.PP
Nikos Mavroyanopoulos <nmav@gnutls.org> and others; see
/usr/share/doc/gnutls\-bin/AUTHORS for a complete list.
.PP
This manual page was written by Ivo Timmermans <ivo@debian.org>, for
the Debian GNU/Linux system (but may be used by others).