← Back to branch summary

~ubuntu-branches/ubuntu/lucid/seamonkey/lucid-security

« back to all changes in this revision

Viewing changes to security/nss-fips/lib/freebl/mpi/doc/basecvt.pod

  • Committer: Bazaar Package Importer
  • Author(s): Fabien Tassin
  • Date: 2008-07-29 21:29:02 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20080729212902-spm9kpvchp9udwbw
Tags: 1.1.11+nobinonly-0ubuntu1
https://launchpad.net/bugs/218534
* New security upstream release: 1.1.11 (LP: #218534)
  Fixes USN-602-1, USN-619-1, USN-623-1 and USN-629-1
* Refresh diverged patch:
  - update debian/patches/80_security_build.patch
* Fix FTBFS with missing -lfontconfig
  - add debian/patches/11_fix_ftbfs_with_fontconfig.patch
  - update debian/patches/series
* Build with default gcc (hardy: 4.2, intrepid: 4.3)
  - update debian/rules
  - update debian/control

Show diffs side-by-side

added added

removed removed

Lines of Context:
security/nss-fips/lib/freebl/mpi/doc/basecvt.pod
 
1
=head1 NAME
 
2
 
 
3
 basecvt - radix conversion for arbitrary precision integers
 
4
 
 
5
=head1 SYNOPSIS
 
6
 
 
7
 basecvt <ibase> <obase> [values]
 
8
 
 
9
=head1 DESCRIPTION
 
10
 
 
11
The B<basecvt> program is a command-line tool for converting integers
 
12
of arbitrary precision from one radix to another.  The current version
 
13
supports radix values from 2 (binary) to 64, inclusive.  The first two
 
14
command line arguments specify the input and output radix, in base 10.
 
15
Any further arguments are taken to be integers notated in the input
 
16
radix, and these are converted to the output radix.  The output is
 
17
written, one integer per line, to standard output.
 
18
 
 
19
When reading integers, only digits considered "valid" for the input
 
20
radix are considered.  Processing of an integer terminates when an
 
21
invalid input digit is encountered.  So, for example, if you set the
 
22
input radix to 10 and enter '10ACF', B<basecvt> would assume that you
 
23
had entered '10' and ignore the rest of the string.
 
24
 
 
25
If no values are provided, no output is written, but the program
 
26
simply terminates with a zero exit status.  Error diagnostics are
 
27
written to standard error in the event of out-of-range radix
 
28
specifications.  Regardless of the actual values of the input and
 
29
output radix, the radix arguments are taken to be in base 10 (decimal)
 
30
notation.
 
31
 
 
32
=head1 DIGITS
 
33
 
 
34
For radices from 2-10, standard ASCII decimal digits 0-9 are used for
 
35
both input and output.  For radices from 11-36, the ASCII letters A-Z
 
36
are also included, following the convention used in hexadecimal.  In
 
37
this range, input is accepted in either upper or lower case, although
 
38
on output only lower-case letters are used.
 
39
 
 
40
For radices from 37-62, the output includes both upper- and lower-case
 
41
ASCII letters, and case matters.  In this range, case is distinguished
 
42
both for input and for output values.
 
43
 
 
44
For radices 63 and 64, the characters '+' (plus) and '/' (forward
 
45
solidus) are also used.  These are derived from the MIME base64
 
46
encoding scheme.  The overall encoding is not the same as base64,
 
47
because the ASCII digits are used for the bottom of the range, and the
 
48
letters are shifted upward; however, the output will consist of the
 
49
same character set.
 
50
 
 
51
This input and output behaviour is inherited from the MPI library used
 
52
by B<basecvt>, and so is not configurable at runtime.
 
53
 
 
54
=head1 SEE ALSO
 
55
 
 
56
 dec2hex(1), hex2dec(1)
 
57
 
 
58
=head1 AUTHOR
 
59
 
 
60
 Michael J. Fromberger <sting@linguist.dartmouth.edu>
 
61
 Thayer School of Engineering, Hanover, New Hampshire, USA
 
62
 
 
63
 $Date: 2000/07/14 00:44:31 $