System i: Programming Secure Sockets APIs - IBM

More documents

Recommendations

Info

Related Information . . . . . . . . . .40 gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session . . . . . . . .41 Parameters . . . . . . . . . . . . .41 Authorities . . . . . . . . . . . . .42 Return Value . . . . . . . . . . . . .42 Error Conditions . . . . . . . . . . . .43 Usage Notes . . . . . . . . . . . . .43 Error Messages . . . . . . . . . . . .44 Related Information . . . . . . . . . .44 gsk_secure_soc_open()—Get a handle for a secure session . . . . . . . . . . . . . . . .44 Parameters . . . . . . . . . . . . .44 Authorities . . . . . . . . . . . . .44 Return Value . . . . . . . . . . . . .44 Error Conditions . . . . . . . . . . . .45 Usage Notes . . . . . . . . . . . . .45 Error Messages . . . . . . . . . . . .45 Related Information . . . . . . . . . .45 gsk_secure_soc_read()—Receive data on a secure session . . . . . . . . . . . . . . . .46 Parameters . . . . . . . . . . . . .46 Authorities . . . . . . . . . . . . .46 Return Value . . . . . . . . . . . . .46 Error Conditions . . . . . . . . . . . .47 Usage Notes . . . . . . . . . . . . .47 Error Messages . . . . . . . . . . . .48 Related Information . . . . . . . . . .48 gsk_secure_soc_startInit()—Start asynchronous operation to negotiate a secure session . . . . .48 Parameters . . . . . . . . . . . . .49 Authorities . . . . . . . . . . . . .50 Return Values . . . . . . . . . . . .50 Error Conditions . . . . . . . . . . . .50 Error Messages . . . . . . . . . . . .51 Related Information . . . . . . . . . .51 gsk_secure_soc_startRecv()—Start asynchronous receive operation on a secure session . . . . . .52 Parameters . . . . . . . . . . . . .52 Authorities . . . . . . . . . . . . .53 Return Values . . . . . . . . . . . .53 Error Conditions . . . . . . . . . . . .54 Error Messages . . . . . . . . . . . .55 Related Information . . . . . . . . . .55 gsk_secure_soc_startSend()—Start asynchronous send operation on a secure session . . . . . .56 Parameters . . . . . . . . . . . . .56 Authorities . . . . . . . . . . . . .58 Return Values . . . . . . . . . . . .58 Error Conditions . . . . . . . . . . . .58 Error Messages . . . . . . . . . . . .59 Usage Notes . . . . . . . . . . . . .59 Related Information . . . . . . . . . .60 gsk_secure_soc_write()—Send data on a secure session . . . . . . . . . . . . . . . .60 Parameters . . . . . . . . . . . . .60 Authorities . . . . . . . . . . . . .61 Return Value . . . . . . . . . . . . .61 Error Conditions . . . . . . . . . . . .61 Usage Notes . . . . . . . . . . . . .62 Error Messages . . . . . . . . . . . .62 iv System i: Programming Secure Sockets APIs Related Information . . . . . . . . . .62 gsk_strerror()—Retrieve GSKit runtime error message . . . . . . . . . . . . . . .62 Parameters . . . . . . . . . . . . .63 Authorities . . . . . . . . . . . . .63 Return Value . . . . . . . . . . . . .63 Usage Notes . . . . . . . . . . . . .63 Related Information . . . . . . . . . .63 Example . . . . . . . . . . . . . .64 i5/OS Secure Sockets Layer (SSL_) APIs . . . . .64 QlgSSL_Init()—Initialize the Current Job for SSL (using NLS-enabled path name) . . . . . . .65 Parameters . . . . . . . . . . . . .65 Authorities . . . . . . . . . . . . .67 Return Value . . . . . . . . . . . . .67 Error Conditions . . . . . . . . . . . .67 Error Messages . . . . . . . . . . . .68 Usage Notes . . . . . . . . . . . . .68 Related Information . . . . . . . . . .68 SSL_Create()—Enable SSL Support for the Specified Socket Descriptor . . . . . . . . . . . .69 Parameters . . . . . . . . . . . . .69 Authorities . . . . . . . . . . . . .69 Return Value . . . . . . . . . . . . .69 Error Conditions . . . . . . . . . . . .70 Error Messages . . . . . . . . . . . .71 Usage Notes . . . . . . . . . . . . .71 Related Information . . . . . . . . . .71 SSL_Destroy()—End SSL Support for the Specified SSL Session . . . . . . . . . . . . . .71 Parameters . . . . . . . . . . . . .72 Authorities . . . . . . . . . . . . .72 Return Value . . . . . . . . . . . . .72 Error Conditions . . . . . . . . . . . .72 Error Messages . . . . . . . . . . . .73 Usage Notes . . . . . . . . . . . . .73 Related Information . . . . . . . . . .74 SSL_Handshake()—Initiate the SSL Handshake Protocol . . . . . . . . . . . . . . .74 Parameters . . . . . . . . . . . . .74 Authorities . . . . . . . . . . . . .76 Return Value . . . . . . . . . . . . .76 Error Conditions . . . . . . . . . . . .77 Error Messages . . . . . . . . . . . .79 Usage Notes . . . . . . . . . . . . .79 Related Information . . . . . . . . . .80 SSL_Init()—Initialize the Current Job for SSL . . .80 Parameters . . . . . . . . . . . . .80 Authorities . . . . . . . . . . . . .82 Return Value . . . . . . . . . . . . .82 Error Conditions . . . . . . . . . . . .83 Error Messages . . . . . . . . . . . .83 Usage Notes . . . . . . . . . . . . .83 Related Information . . . . . . . . . .84 SSL_Init_Application()—Initialize the Current Job for SSL Processing Based on the Application Identifier . . . . . . . . . . . . . . .84 Parameters . . . . . . . . . . . . .84 Authorities . . . . . . . . . . . . .87 Return Value . . . . . . . . . . . . .87 Error Conditions . . . . . . . . . . . .88
Error Messages . . . . . . . . . . . .88 Usage Notes . . . . . . . . . . . . .88 Related Information . . . . . . . . . .89 SSL_Perror()—Print SSL Error Message . . . . .89 Parameters . . . . . . . . . . . . .90 Authorities . . . . . . . . . . . . .90 Return Value . . . . . . . . . . . . .90 Error Conditions . . . . . . . . . . . .90 Error Messages . . . . . . . . . . . .90 Related Information . . . . . . . . . .90 Example . . . . . . . . . . . . . .90 SSL_Read()—Receive Data from an SSL-Enabled Socket Descriptor . . . . . . . . . . . .91 Parameters . . . . . . . . . . . . .92 Authorities . . . . . . . . . . . . .92 Return Value . . . . . . . . . . . . .92 Error Conditions . . . . . . . . . . . .93 Error Messages . . . . . . . . . . . .94 Usage Notes . . . . . . . . . . . . .94 Related Information . . . . . . . . . .95 SSL_Strerror()—Retrieve SSL Runtime Error Message . . . . . . . . . . . . . . .95 Parameters . . . . . . . . . . . . .95 Authorities . . . . . . . . . . . . .96 Return Value . . . . . . . . . . . . .96 Error Conditions . . . . . . . . . . . .96 Error Messages . . . . . . . . . . . .96 Related Information . . . . . . . . . .96 Example . . . . . . . . . . . . . .96 SSL_Write()—Write Data to an SSL-Enabled Socket Descriptor . . . . . . . . . . . . . . .97 Parameters . . . . . . . . . . . . .97 Authorities . . . . . . . . . . . . .98 Return Value . . . . . . . . . . . . .98 Error Conditions . . . . . . . . . . . .98 Error Messages . . . . . . . . . . . . 100 Usage Notes . . . . . . . . . . . . . 100 Related Information . . . . . . . . . . 100 Concepts . . . . . . . . . . . . . . . 100 Header Files for UNIX-Type Functions . . . . . 100 Errno Values for UNIX-Type Functions . . . . . 103 Code license and disclaimer information . . . . 111 Appendix. Notices . . . . . . . . . 113 Programming interface information . . . . . .114 Trademarks . . . . . . . . . . . . . .115 Terms and conditions . . . . . . . . . . .116 Contents v
Page 1: System i Programming Secure Sockets
Page 4 and 5: Note Before using this information
Page 8 and 9: vi System i: Programming Secure Soc
Page 10 and 11: APIs These are the APIs for this ca
Page 12 and 13: ufID (Input) The following values c
Page 14 and 15: v GSK_CONNECT_CIPHER_SPEC v GSK_SID
Page 16 and 17: [GSK_INSUFFICIENT_STORAGE] Not able
Page 18 and 19: gsk_attribute_get_enum()—Get enum
Page 20 and 21: secure session does not start, and
Page 22 and 23: API introduced: V5R1 Top | UNIX-Typ
Page 24 and 25: v GSK_FD v GSK_HANDSHAKE_TIMEOUT v
Page 26 and 27: [GSK_INVALID_STATE] One of the foll
Page 28 and 29: 8. If GSK_OS400_APPLICATION_ID is s
Page 30 and 31: if validation fails because the cer
Page 32 and 33: gsk_attribute_set_enum()—Set enum
Page 34 and 35: active secure sessions will continu
Page 36 and 37: gsk_attribute_set_numeric_value()
Page 38 and 39: v GSK_V3_SIDCACHE_SIZE v GSK_LDAP_S
Page 40 and 41: v “gsk_secure_soc_init()—Negoti
Page 42 and 43: [ETERM] Operation terminated. If an
Page 44 and 45: 2. v GSK_SESSION_TYPE set to GSK_CL
Page 46 and 47: Error Messages Message ID Error Mes
Page 48 and 49: [GSK_AS400_ERROR_INVALID_POINTER] T
Page 50 and 51: attributes. In most cases, as resul
Page 52 and 53: Error Messages Message ID Error Mes
Page 54 and 55: v “gsk_secure_soc_misc()—Perfor
Page 56 and 57:
matched sets. If a client applicati
Page 58 and 59:
Authorities Authorization of *R (al
Page 60 and 61:
gsk_secure_soc_startRecv()—Start
Page 62 and 63:
The handle specified was not valid.
Page 64 and 65:
v “gsk_secure_soc_misc()—Perfor
Page 66 and 67:
Authorities No authorization is req
Page 68 and 69:
6. Socket option SO_SNDTIMEO is not
Page 70 and 71:
[EPIPE] [EUNATCH] The specified des
Page 72 and 73:
Example The following example shows
Page 74 and 75:
Qlg_Path_Name_T *keyringFileName (i
Page 76 and 77:
v The CCSID specified in the keyrin
Page 78 and 79:
unsigned protocol; /* SSL protocol
Page 80 and 81:
Service Program Name: QSOSSLSR Defa
Page 82 and 83:
Related Information v “SSL_Create
Page 84 and 85:
unsigned int cipherSuiteListLen The
Page 86 and 87:
[EBADF] [EBUSY] Permission denied.
Page 88 and 89:
ignore attempts by applications to
Page 90 and 91:
C Constant System Value TLS_RSA_WIT
Page 92 and 93:
ignore attempts by applications to
Page 94 and 95:
v Use the system default cipher spe
Page 96 and 97:
An error occurred in SSL processing
Page 98 and 99:
Parameters int sslreturnvalue (Inpu
Page 100 and 101:
Parameters SSLHandle* handle (input
Page 102 and 103:
[EUNATCH] [EUNKNOWN] The protocol r
Page 104 and 105:
Authorities No authorization is req
Page 106 and 107:
struct SSLHandleStr { /* SSLHandleS
Page 108 and 109:
Error Messages Message ID Error Mes
Page 110 and 111:
Name of Header File Name of File in
Page 112 and 113:
Name Value Text Details ENOTWRITE 3
Page 114 and 115:
Name Value Text Details EHOSTDOWN 3
Page 116 and 117:
Name Value Text Details EISDIR 3471
Page 118 and 119:
Name Value Text Details EBADFID 351
Page 120 and 121:
CONDITIONS OF MERCHANTABILITY, FITN
Page 122 and 123:
IBM Corporation Software Interopera
Page 124 and 125:
SAA SecureWay SOM System i System i
Page 126:
118 System i: Programming Secure So
show all

System i: Programming Secure Sockets APIs - IBM

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?