.TH ssl 7 "ssl 5.3.6" "Ericsson AB" "Erlang Application Definition"
.SH NAME
ssl \- The SSL application provides secure communication over
  sockets.

.SH "DEPENDENCIES"

.LP
The ssl application uses the Erlang applications public_key and crypto to handle public keys and encryption, hence these applications needs to be loaded for the ssl application to work\&. In an embedded environment that means they need to be started with application:start/[1,2] before the ssl application is started\&.
.SH "ENVIRONMENT"

.LP
The following application environment configuration parameters are defined for the SSL application\&. See \fBapplication(3erl)\fR\&for more information about configuration parameters\&.
.LP
Note that the environment parameters can be set on the command line, for instance,
.LP
\fIerl \&.\&.\&. -ssl protocol_version \&'[tlsv1\&.1, tlsv1]\&' \&.\&.\&.\fR\&\&.
.RS 2
.TP 2
.B
\fIprotocol_version = [tlsv1|tlsv1\&.1|tlsv1\&.2] <optional>\fR\&\&.:
Protocol that will be supported by started clients and servers\&. If this option is not set it will default to all protocols currently supported by the erlang ssl application\&. Note that this option may be overridden by the version option to ssl:connect/[2,3] and ssl:listen/2\&.
.RS 2
.LP
For Debian GNU/Linux distribution the sslv3 protocol was disabled due to its security issues\&.
.RE

.TP 2
.B
\fIsession_lifetime = integer() <optional>\fR\&:
The lifetime of session data in seconds\&.
.TP 2
.B
\fIsession_cb = atom() <optional>\fR\&:
Name of session cache callback module that implements the ssl_session_cache_api behavior, defaults to ssl_session_cache\&.erl\&.
.TP 2
.B
\fIsession_cb_init_args = list() <optional>\fR\&:
List of arguments to the init function in session cache callback module, defaults to []\&.
.RE
.SH "SEE ALSO"

.LP
\fBapplication(3erl)\fR\&