Extracted from Pike v7.8 release 866 at 2016-11-06.
pike.ida.liu.se
[Top]
SSL
SSL.sslfile

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.