← Back to branch summary

~ubuntu-branches/ubuntu/saucy/gnutls28/saucy

« back to all changes in this revision

Viewing changes to doc/functions/gnutls_x509_crt_set_serial

  • Committer: Package Import Robot
  • Author(s): Jeremy Bicha
  • Date: 2013-07-30 21:40:07 UTC
  • mfrom: (14.1.9 saucy-proposed)
  • Revision ID: package-import@ubuntu.com-20130730214007-9mrd08xo61kla008
Tags: 3.2.3-1ubuntu1
https://launchpad.net/bugs/1068029
* Sync with Debian (LP: #1068029). Remaining change:
  - Drop gnutls-bin and -doc since we want to use the versions
    in gnutls26 as the defaults instead

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/functions/gnutls_x509_crt_set_serial
10
10
@var{serial_size}: Holds the size of the serial field.
11
11
 
12
12
This function will set the X.509 certificate's serial number.
13
 
Serial is not always a 32 or 64bit number.  Some CAs use large
14
 
serial numbers, thus it may be wise to handle it as something
15
 
uint8_t.
 
13
While the serial number is an integer, it is often handled
 
14
as an opaque field by several CAs. For this reason this function
 
15
accepts any kind of data as a serial number. To be consistent
 
16
with the X.509/PKIX specifications the provided  @code{serial} should be 
 
17
a big-endian positive number (i.e. it's leftmost bit should be zero).
16
18
 
17
19
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
18
20
negative error value.