85 lines
4.7 KiB
HTML
85 lines
4.7 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>i5/OS Secure Sockets Layer (SSL_) APIs</title>
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<!-- Begin Header Records ========================================= -->
|
||
|
|
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
|
||
|
|
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
|
||
|
|
<!-- File restructured December 2001 -->
|
||
|
|
<!-- 031112 JETAYLOR replaced API and/or Exit listings with -->
|
||
|
|
<!-- pagegenerator output from javascript array -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<h2>i5/OS Secure Sockets Layer (SSL_) APIs</h2>
|
||
|
|
|
||
|
|
<p>i5/OS<SUP>(TM)</SUP> SSL_ APIs, when used in addition to the existing i5/OS Sockets APIs,
|
||
|
|
provide the functions required for applications to establish secure
|
||
|
|
communications. An application using SSL for secure communications is basically
|
||
|
|
a client/server application written using sockets.</p>
|
||
|
|
|
||
|
|
<p>The SSL_ APIs are:</p>
|
||
|
|
|
||
|
|
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
|
||
|
|
<!-- Updates made in this section *will* be overlaid by pagegen tool. -->
|
||
|
|
<!-- Notify Beth Taylor of needed updates to be made in javascript array.-->
|
||
|
|
<!--***************API BEGIN PASTE***************-->
|
||
|
|
<ul>
|
||
|
|
<li><A HREF="sslinitu.htm">QlgSSL_Init()</A> (Initialize the current job for SSL (using NLS-enabled path name)) is used to establish the SSL security information to be used for all SSL sessions for the current job.</li>
|
||
|
|
<li><A HREF="sslcreat.htm">SSL_Create()</A> (Enable SSL support for the specified socket descriptor) is used by a program to enable SSL support for the specified socket descriptor.</li>
|
||
|
|
<li><A HREF="ssldest.htm">SSL_Destroy()</A> (End SSL support for the specified SSL session) is used by a program to end SSL support for the specified SSL session.</li>
|
||
|
|
<li><A HREF="sslhands.htm">SSL_Handshake()</A> (Initiate the SSL handshake protocol) is used by a program to initiate the SSL handshake protocol. Both the client and the server program must call the SSL_Handshake verb in order to initiate the handshake processing.</li>
|
||
|
|
<li><A HREF="sslinit.htm">SSL_Init()</A> (Initialize the current job for SSL) is used to establish the SSL security information to be used for all SSL sessions for the current job.</li>
|
||
|
|
<li><A HREF="sslinita.htm">SSL_Init_Application()</A> (Establish the SSL security information) is used to establish the SSL security information to be used for all SSL sessions for the current job based on the specified application identifier.</li>
|
||
|
|
<li><A HREF="sslperr.htm">SSL_Perror()</A> (Print SSL error message) prints an error message to stderr.</li>
|
||
|
|
<li><A HREF="sslread.htm">SSL_Read()</A> (Receive data from an SSL-enabled socket descriptor) is used by a program to receive data from an SSL-enabled socket descriptor.</li>
|
||
|
|
<li><A HREF="sslstrer.htm">SSL_Strerror()</A> (Retrieve SSL runtime error message) is used to retrieve an error message and associated text string which describes an SSL return value.</li>
|
||
|
|
<li><A HREF="sslwrite.htm">SSL_Write()</A> (Write data to an SSL-enabled socket descriptor) is used by a program to write data to an SSL-enabled socket descriptor.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************API END PASTE***************-->
|
||
|
|
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> These functions use header (include) files from the
|
||
|
|
library QSYSINC, which is optionally installable. Make sure QSYSINC is
|
||
|
|
installed on your system before using any of the functions. See <a href=
|
||
|
|
"unix13.htm">Header Files for UNIX-Type Functions</a> for the file and member
|
||
|
|
name of each header file.</p>
|
||
|
|
|
||
|
|
<p>See the following examples for more information:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="../rzab6/x1sslserver.htm">Example: Establish secure
|
||
|
|
server with SSL APIs</a></li>
|
||
|
|
|
||
|
|
<li><a href="../rzab6/x1sslclient.htm">Example: Establish secure
|
||
|
|
client with SSL APIs</a>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<table align="center" cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="unix.htm">UNIX-Type APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|