Pike v8.0 release 1738

Class SSL.sslfile

Description

Interface similar to Stdio.File.

  • Handles blocking and nonblocking mode.

  • Handles callback mode in an arbitrary backend (also in blocking mode).

  • Read and write operations might each do both reading and writing. In callback mode that means that installing either a read or a write callback might install both internally. It also means that reading in one thread while writing in another doesn't work.

  • Callback changing operations like set_blocking and set_nonblocking aren't atomic.

  • Apart from the above, thread safety/atomicity characteristics are retained.

  • Blocking characterstics are retained for all functions.

  • is_open, connection init (create) and close (close) can do both reading and writing.

  • destroy attempts to close the stream properly by sending the close packet, but since it can't do blocking I/O it's not certain that it will succeed. The stream should therefore always be closed with an explicit close call.

  • Abrupt remote close without the proper handshake gets the errno System.EPIPE.

  • Objects do not contain cyclic references, so they are closed and destructed timely when dropped.


Variable next_protocol

string SSL.sslfile.next_protocol

Description

The next protocol chosen by the client during next protocol negotiation.

Note

Read only


Method create

SSL.sslfile SSL.sslfile(Stdio.File stream, SSL.context ctx, int|void is_client, int|void is_blocking, SSL.Constants.ProtocolVersion|void min_version, SSL.Constants.ProtocolVersion|void max_version)

Description

Create an SSL connection over an open stream.

Parameter stream

Open socket or pipe to create the connection over.

Parameter ctx

The SSL context.

Parameter is_client

If is set then a client-side connection is started, server-side otherwise.

Parameter is_blocking

If is set then the stream is initially set in blocking mode, nonblocking mode otherwise.

Parameter min_version

The minimum minor version of SSL to support. Defaults to PROTOCOL_SSL_3_0.

Parameter max_version

The maximum minor version of SSL to support. Defaults to PROTOCOL_minor.

The backend used by stream is taken over and restored after the connection is closed (see close and shutdown). The callbacks and id in stream are overwritten.

Throws

Throws errors on handshake failure in blocking client mode.


Method destroy

protected void destroy()

Description

Try to close down the connection properly since it's customary to close files just by dropping them. No guarantee can be made that the close packet gets sent successfully though, because we can't risk blocking I/O here. You should call close explicitly.

See also

close