1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<!--========================================================================== 3 Copyright 2008 Nintendo. All rights reserved. 4 5 These coded instructions, statements, and computer programs contain 6 proprietary information of Nintendo of America Inc. and/or Nintendo 7 Company Ltd., and are protected by Federal copyright law. They may 8 not be disclosed to third parties or copied or duplicated in any form, 9 in whole or in part, without the prior written consent of Nintendo. 10 ==========================================================================--> 11<HTML> 12<HEAD> 13 <META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 14 <META http-equiv="Content-Style-Type" content="text/css"> 15 <TITLE>CRYPTO_RSA_Sign</TITLE> 16 <LINK rel="stylesheet" href="../../css/nitro.css"> 17 <BASE target="main"> 18</HEAD> 19<BODY> 20<H1>CRYPTO_RSA_Sign <IMG src="../../image/BPT.gif" width="23" height="12" border="0" align="middle"><IMG src="../../image/TWL.gif" width="23" height="12" border="0" align="middle"></H1> 21 22<H2>Syntax</H2> 23<DL> 24 <DD> 25 <PRE><CODE> 26#include <nitro/crypto.h> 27 28s32 CRYPTO_RSA_Sign(<a href="CRYPTORSASignContext.html">CRYPTORSASignContext</a> *context, <a href="CRYPTORSASignParam.html">CRYPTORSASignParam</a> *param); 29 </CODE></PRE> 30 </DD> 31</DL> 32 33<H2>Arguments</H2> 34<TABLE border="1"> 35 <TBODY> 36 <TR> 37 <TD width="25%"><EM><STRONG><CODE>context</CODE></STRONG></EM></TD> 38 <TD width="75%">Specifies the address of the <code><a href="CRYPTORSASignContext.html">CRYPTORSASignContext</a></code> structure that was initialized by the <code><a href="CRYPTO_RSA_SignInit.html">CRYPTO_RSA_SignInit</a></code> function.</TD> 39 </TR> 40 <TR> 41 <TD><EM><STRONG><CODE>param</CODE></STRONG></EM></TD> 42 <TD>Specifies the address of the structure for specifying strings and other data for creating signatures.</TD> 43 </TR> 44 </TBODY> 45</TABLE> 46 47<H2>Return Values</H2> 48<P> 49 Returns one of the following process results. 50</P> 51<TABLE border="1"> 52 <TBODY> 53 <TR> 54 <TD width="25%"><EM><STRONG><CODE>Positive number</CODE></STRONG></EM></TD> 55 <TD width="75%">Number of strings that were written to the output buffer (indicates that signature creation succeeded)</TD> 56 </TR> 57 <TR> 58 <TD><EM><STRONG><CODE>-1</CODE></STRONG></EM></TD> 59 <TD>Indicates that signature creation failed</TD> 60 </TR> 61 </TBODY> 62</TABLE> 63 64<H2>Description</H2> 65<P> 66 Creates a digital signature.<BR> 67 The <code><a href="CRYPTO_RSA_SignInit.html">CRYPTO_RSA_SignInit</a></code> function must be run before running digital signature creation-related code with this function. In addition, the <code><a href="CRYPTO_RSA_SignTerminate.html">CRYPTO_RSA_SignTerminate</a></code> function must be run when cryptography operations have completed. 68</P> 69<P> 70 The information required for digital signature creation, such as the string to be digitally signed and the output destination, must be specified in the members of the <EM><CODE><STRONG>param</STRONG></CODE></EM> argument. For details, refer to <code><a href="CRYPTORSASignParam.html">CRYPTORSASignParam</a></code>. 71</P> 72<P> 73 For detailed information on creating digital signatures, see <A href="../overview/about_Signature.html">Digital Signature Overview</A>. 74</P> 75 76<H2>See Also</H2> 77<P> 78 <CODE> 79 <A href="CRYPTO_RSA_SignInit.html">CRYPTO_RSA_SignInit</A>, <A href="CRYPTO_RSA_SignTerminate.html">CRYPTO_RSA_SignTerminate</A> 80 </CODE> 81</P> 82 83<H2>Revision History</H2> 84<P> 85 2008/04/17 Initial version. 86</P> 87 88<hr><p>CONFIDENTIAL</p></body> 89</HTML> 90
