github.com/JimmyHuang454/JLS-go@v0.0.0-20230831150107-90d536585ba0/boring/README.md (about)

     1  We have been working inside Google on a fork of Go that uses
     2  BoringCrypto (the core of [BoringSSL](https://boringssl.googlesource.com/boringssl/))
     3  for various crypto primitives, in furtherance of some work related to FIPS 140.
     4  We have heard that some external users of Go would be
     5  interested in this code as well, so we have published this code
     6  here in the main Go repository behind the setting GOEXPERIMENT=boringcrypto.
     7  
     8  Use of GOEXPERIMENT=boringcrypto outside Google is _unsupported_.
     9  This mode is not part of the [Go 1 compatibility rules](https://go.dev/doc/go1compat),
    10  and it may change incompatibly or break in other ways at any time.
    11  
    12  To be clear, we are not making any statements or representations about
    13  the suitability of this code in relation to the FIPS 140 standard.
    14  Interested users will have to evaluate for themselves whether the code
    15  is useful for their own purposes.
    16  
    17  ---
    18  
    19  This directory holds the core of the BoringCrypto implementation
    20  as well as the build scripts for the module itself: syso/*.syso.
    21  
    22  syso/goboringcrypto_linux_amd64.syso is built with:
    23  
    24  	GOARCH=amd64 ./build.sh
    25  
    26  syso/goboringcrypto_linux_arm64.syso is built with:
    27  
    28  	GOARCH=arm64 ./build.sh
    29  
    30  Both run on an x86 Debian Linux system using Docker.
    31  For the arm64 build to run on an x86 system, you need
    32  
    33  	apt-get install qemu-user-static qemu-binfmt-support
    34  
    35  to allow the x86 kernel to run arm64 binaries via QEMU.
    36  
    37  See build.sh for more details about the build.
    38  
    39