16985N/A#

17640N/A# CDDL HEADER START

17640N/A#

17640N/A# The contents of this file are subject to the terms of the

17640N/A# Common Development and Distribution License (the "License").

17640N/A# You may not use this file except in compliance with the License.

17640N/A#

17640N/A# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

17640N/A# or http://www.opensolaris.org/os/licensing.

17640N/A# See the License for the specific language governing permissions

17640N/A# and limitations under the License.

17291N/A#

17291N/A# When distributing Covered Code, include this CDDL HEADER in each

17291N/A# file and include the License file at usr/src/OPENSOLARIS.LICENSE.

17291N/A# If applicable, add the following below this CDDL HEADER, with the

17641N/A# fields enclosed by brackets "[]" replaced with your own identifying

16985N/A# information: Portions Copyright [yyyy] [name of copyright owner]

16985N/A#

16985N/A# CDDL HEADER END

16985N/A#

16985N/A# Copyright (c) 2009, 2013, Oracle and/or its affiliates. All rights reserved.

16985N/A#

16985N/A

16985N/A

16985N/ABuild Layout

16985N/A---

17640N/A

17640N/AOpenSSL build is run four times. Once for regular dynamic 1.0.0 non-fips, once

17640N/Afor static 1.0.0 bits to link with standalone wanboot binary, once for 0.9.8

16985N/Afips-140, and once for 0.9.8 FIPS-140 canister (in the openssl-fips component)

16985N/Aneeded to build 0.9.8 FIPS-140 certified libraries. All builds apart from

16985N/Astatic libraries for wanboot are done for 32 and 64 bits. So, in total, OpenSSL

16985N/Ais built seven times. OpenSSL for wanboot is only build on sparc.

16985N/A

16985N/ASee also comments in all the Makefiles for more information.

16985N/A

16985N/AOpenSSL Version

16985N/A---

16985N/A

16985N/AFor non-FIPS build, we currently deliver OpenSSL 1.0.1e with some updates

16985N/Afrom OpenSSL 1.0.2 to make T4 instructions embedded in the OpenSSL

16985N/Aupstream code. As of April 2013, 1.0.2 is not yet released, and therefore,

16985N/Awe have decided to patch the code.

16985N/AThe following files/code are copied in from 1.0.2.

16985N/Aadded:

16985N/A components/openssl/openssl-1.0.1/inline-t4/md5-sparcv9.pl

16985N/A components/openssl/openssl-1.0.1/inline-t4/sparc_arch.h

17641N/A components/openssl/openssl-1.0.1/patches/openssl-t4-inline.sparc-patch

17641N/ATPNO for OpenSSL 1.0.1e is 13003.

17862N/A

17641N/AFor FIPS build, we currently deliver OpenSSL 0.9.8y with OpenSSL FIPS module 2.1.

17862N/ATPNO for OpenSSL 0.9.8y is 13019.

16985N/A

16985N/A

16985N/AThe non-fips Build.

17291N/A---

16985N/A

17291N/AThe non-fips build is the main build of OpenSSL and includes the regular

16985N/Abinaries, libraries, man pages, and header files.

16985N/A

16985N/APatches

16985N/A---

17291N/A

16985N/AGive CA.pl better defaults. See 6193522 for more information.

16985N/A

20777N/AMake sure the HMAC_CTX_init(3) man page gets delivered. See 6546806 for

16985N/Amore information.

16985N/A

16985N/AForce openssl to install man pages into man[1357]openssl instead of man[1357].

17640N/A

17640N/APatch which adds the pkcs11 engine. See also the pkcs11-engine/

16985N/Asub-directory.

Adds five Solaris specific configurations (both 32bit and 64bit for both sparc

and x86, plus 64bit sparc for wanboot) to Configure which are then explicitly

used by the Makefiles. Wanboot configuration is special in that it doesn't link

with libc and uses -xF=%all to put functions in separate sections, so that

unused code can be discarded.

Care should be taken if modifying this patch as changes to compile-time options

can change the ABI. One example of this is the use of RC4_INT vs RC4_CHAR.

Prevent build binaries having an unnecessary runpath (/lib).

Build with non-executable stacks and non-executable data (x86).

Modifies Makefile.shared so that libssl is built with -znodelete.

Adds a new "enginesdir" option to the Configure script which allows a user to

specify the engines directory.

Modifies engines/Makefile so that the devcrypto engine will be built in the

"engines" directory.

30_wanboot.patch:

Wanboot specific patches.

- modified Makefiles not to build in engines apps test tools

- not using vfprintf for error print in crypto/cryptlib.c

- not using ERR_load_DSO_strings() in crypto/err/err_all.c

- not using EVP_read_pw_string() in crypto/evp/evp_key.c

- reading password is implemented in disabled DES library

- avoid select() in crypto/rand/rand_unix.c

- direct reading of IP to avoid sscanf() in crypto/x509v3/v3_utl.c

- using functions from libsock in e_os.h

- by-passing version of sparc detection in crypto/sparcv9cap.c

- results in not using FPU for big numbers multiplication

- should be ok - original detection seems broken, FPU gets never used

- implementation of atoi()

Fix DTLS_BAD_VER bug reported after OpenSSL 1.0.1e is released.

SPARC-only patch.

Add a built-in engine, t4, to support SPARC T4 crypto instructions.

along with files in directory engines/t4.

SPARC-only patch.

Add patch to support inline T4 instruction in OpenSSL upstream code until

OpenSSL 1.0.2 is released.

Modifies opensslconf.h so that it is suitable for both 32bit and 64bit installs.

OpenSSL either builds for 32bit or 64bit - it doesn't allow for combined 32bit

and 64bit builds.

The fips Build

---

FIPS-140 certified libraries for Solaris private use. We wait for OpenSSL 1.0.0

to be FIPS-140 certified in which time we can ship only 1.0.0 with S11 and make

it a public interface.

Patches

---

All the patches from 1.0.0 are used in 0.9.8 as well aside from

14-manpage_openssl.patch which is not needed since we do not deliver 0.9.8 man

pages. Additional patches:

Fixing a bug introduces in 0.9.8q and fixed in 0.9.8r.

Workaround so that fingerprinting the canister during runtime and comparing it

with the saved fingerprint works correctly.

The wanboot Build

----

There are some significant differences when building OpenSSL for wanboot.

Some additional Configuration options are needed:

-DNO_CHMOD chmod not available in stand-alone environment

-DBOOT guard for wanboot specific patches

-DOPENSSL_NO_DTLS1 to avoid dtls1_min_mtu() - DTLS not used anyway

List of object files for wanboot-openssl.o

----

At this moment, object files for wanboot-openssl.o need to be listed explicitly.

This is cumbersome and relatively tedious with respect to upgrading to higher

version of openssl.

In future, it would be nice, if this could be performed automatically by the

linker. The required interface for wanboot is already defined in a mapfile and

linker option '-zdiscard-unused=sections,files' is already used to discard

unused code.

But sadly, at this moment when the linker is given all the object files, it

correctly discards some unused files, but references to undefined symbols from

the discarded files don't get discarded along. Later, these undefined references

cause wanboot linking failure.

In order to determine which openssl object files are required for wanboot,

first build static standalone openssl bits in Userland. As a site effect,

static libraries libssl.a and libcrypto.a are created in build/sparcv9-wanboot.

$ cd $USERLAND/components/openssl/openssl-1.0.0 ; gmake build

Next, collect some information from linking wanboot static libraries in ON.

This can be done by the following hack.

$ cd $ON/usr/src/psm/stand/boot/sparcv9/sun4

$ touch wanboot.o

$ LD_OPTIONS="-Dfiles,symbols,output=ld.dbg \

-L$USERLAND/components/openssl/openssl-1.0.0/build/sparcv9-wanboot " \

WAN_OPENSSL=" -lwanboot -lssl -lcrypto" dmake all

The following sort of information ends up in ld.dbg (note that the debugging

output from the link-editor is not considered a 'stable interface' and may

change in the future):

debug: file=/builds/tkuthan/ul-wanboot-rebuilt/components/openssl/openssl-1.0.0/build/sparcv9-wanboot/libcrypto.a(sparcv9cap.o) [ ET_REL ]

debug:

debug: symbol table processing; file=/builds/tkuthan/ul-wanboot-rebuilt/components/openssl/openssl-1.0.0/build/sparcv9-wanboot/libcrypto.a(sparcv9cap.o) [ ET_REL ]

debug: symbol[1]=sparcv9cap.c

....

Now run the following script in Userland:

#!/bin/bash

# set to workspace paths:

USERLAND=/builds/tkuthan/ul-wanboot-rebuilt

ON=/builds/tkuthan/on11u1-wanboot-rti

BUILD=$USERLAND/components/openssl/openssl-1.0.0/build/sparcv9-wanboot

LD_DBG=$ON/usr/src/psm/stand/boot/sparcv9/sun4/ld.dbg

for i in `find $BUILD/crypto $BUILD/ssl -name '*.o'`

do

f=`basename $i`

if grep -q "^debug: file.*\<$f\>" $LD_DBG

then

echo $i | sed "s#$BUILD/##"

fi

done

to get the list of required object files.

Additionally, you can format the list for including to Makefile by:

sort | tr '\n' ' ' | fold -s -w74 | sed -e 's/^/ /' -e 's/$/\\/'

Linking with wanboot

----

When linking with wanboot please pay attention to following pitfalls.

Correct openssl header files need to be included. This is done in

$ON/usr/src/stand/lib/wanboot/Makefile

Make sure CPPFLAGS point to the right directories.

EXTREME CAUTION needs to be employed, if WANBOOT GREW IN SIZE because of the

changes!

Wanboot is a statically linked standalone binary and it is loaded on a fixed

address before execution. This address is defined in

$ON/usr/src/psm/stand/boot/sparc/common/mapfile:

27 LOAD_SEGMENT text {

28 FLAGS = READ EXECUTE;

29 VADDR = 0x130000;

30 ASSIGN_SECTION {

31 TYPE = PROGBITS;

32 FLAGS = ALLOC !WRITE;

33 };

34 };

This address (VADDR) NEEDS TO BE GREATER THEN

size of wanboot binary + 0x4000

The reason for this is in how wanboot is loaded by OpenBoot Prom:

1) user initiates boot from network - "boot net"

2) obp loads wanboot binary at address 0x4000

3) obp parses ELF header, reads virtual address where to load wanboot to

4) obp mem-copies .text section to this address

5) obp copies .data section behind .text

6) obp starts executing wanboot at entry address

If the given address is too small, obp overwrites part of .data with

instructions from .text in step 4. resulting in .data being corrupted.

Initialized variables get bogus values and failure is inevitable.

This is very hard to troubleshoot.

Testing wanboot with new openssl

----

With every upgrade of OpenSSL, it is necessary to make sure wanboot builds and

works well with the new bits.

Provided you have a freshly built ON workspace, you can link wanboot with new

OpenSSL bits by redefining WAN_OPENSSL macro:

# copy wanboot-openssl.o to ON build machine

cp wanboot-openssl.o /var/tmp/

# prepare to rebuild wanboot

cd $ON

bldenv developer.sh

cd usr/src/psm/stand/boot/sparcv9/sun4

# hack to force a rebuild

touch wanboot.o

# link new OpenSSL to wanboot

WAN_OPENSSL=/var/tmp/wanboot-openssl.o dmake all

Wanboot should build without warning.

If there is something like this in the output:

Undefined first referenced

symbol in file

CRYPTO_ccm128_setiv /var/tmp/wanboot-openssl.o

SSL_get_srtp_profiles /var/tmp/wanboot-openssl.o

ssl_parse_clienthello_use_srtp_ext /var/tmp/wanboot-openssl.o

CRYPTO_gcm128_setiv /var/tmp/wanboot-openssl.o

...

cmac_pkey_meth /var/tmp/wanboot-openssl.o

ld: fatal: symbol referencing errors. No output written to wanboot

*** Error code 1

dmake: Fatal error: Command failed for target `wanboot'

some additional work has to be done in OpenSSL to either satisfy the function

references listed in the linker error message, or to remove the calls to these

functions.

Finally, resulting wanboot binary shall be deployed on some install server and

wanbooting from this server shall be tested.