usr/src/common/bignum/README

   1 #
   2 # CDDL HEADER START
   3 #
   4 # The contents of this file are subject to the terms of the
   5 # Common Development and Distribution License (the "License").
   6 # You may not use this file except in compliance with the License.
   7 #
   8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9 # or http://www.opensolaris.org/os/licensing.
  10 # See the License for the specific language governing permissions
  11 # and limitations under the License.
  12 #
  13 # When distributing Covered Code, include this CDDL HEADER in each
  14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 # If applicable, add the following below this CDDL HEADER, with the
  16 # fields enclosed by brackets "[]" replaced with your own identifying
  17 # information: Portions Copyright [yyyy] [name of copyright owner]
  18 #
  19 # CDDL HEADER END
  20 #
  21 # Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
  22 # Use is subject to license terms.
  23 #
  24
  25 A note on the file mont_mulf.c.
  26
  27 It is used as a starting point for the following hand optimized assembly files:
  28
  29 - usr/src/common/bignum/sun4u/mont_mulf_v8plus.s
  30  This file is used in the 32-bit pkcs11_softtoken library.
  31
  32 - usr/src/common/bignum/sun4u/mont_mulf_v9.s
  33  This file is used in the 64-bit pkcs11_softtoken library.
  34
  35 - usr/src/common/bignum/sun4u/mont_mulf_kernel_v9.s
  36  This file is used in the kernel RSA module.
  37
  38 We keep the .c file around for future reference.
  39
  40 See file bignumimpl.c for information about these preprocessor symbols:
  41         USE_FLOATING_POINT, PSR_MUL, HWCAP, UMUL64
  42 UMUL64 is set in bignum.h based on architecture.
  43 The other symbols are set in Makefiles, as appropriate.