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 #
22 # Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
23
24
25 This directory contains the tools used to do a full build of the
26 OS/Net workspace. They usually live in the /opt/onbld directory on build
27 machines. From here, 'make install' will build and install the tools
28 in $ROOT/opt/onbld.
29
30 Layout of /opt/onbld
31 --------------------
32
33 /opt/onbld/etc/abi
34 contains Solaris ABI database (ABI_*.db) and exceptions
35 for ABI Auditing tool (interface_check, interface_cmp).
36
37 /opt/onbld/bin
38 basic bin directory - contains scripts.
39
40 /opt/onbld/bin/${MACH}
41 architecture-specific bin directory for binaries.
42
65 used with 'nightly,' and starts a shell with the environment
66 set up the same way as 'nightly' set it up. This is useful
67 if you're trying to quickly rebuild portions of a workspace
68 built by 'nightly'. 'ws' should not be used for this since it
69 sets the environment up differently and may cause everything
70 to rebuild (because of different -I or -L paths).
71
72 build_cscope
73 builds cscope databases in the uts, the platform subdirectories
74 of uts, and in usr/src. Uses cscope-fast.
75
76 check_rtime
77 checks ELF attributes used by ELF dynamic objects in the proto area.
78 Used by 'nightly's -r option, to check a number of ELF runtime
79 attributes for consistency with common build rules. nightly uses
80 the -o option to simplify the output for diffing with previous
81 build results. It also uses the -i option to obtain NEEDED and RUNPATH
82 entries, which help detect changes in software dependencies and makes
83 sure objects don't have any strange runpaths like /opt/SUNWspro/lib.
84
85 codereview
86 Given two filenames, creates a postscript file with the file
87 differences highlighted.
88
89 codesign
90 Tools for signing cryptographic modules using the official
91 Sun release keys stored on a remote signing server. This
92 directory contains signit, a client program for signing
93 files with the signing server; signproto, a shell script
94 that finds crypto modules in $ROOT and signs them using
95 signit; and codesign_server.pl, the code that runs on the
96 server. The codesign_server code is not used on an ON
97 build machine but is kept here for source control purposes.
98
99 copyrightchk
100 Checks that files have appropriate SMI copyright notices.
101 Primarily used by wx
102
103 cscope-fast
104 The fast version of cscope that we use internally. Seems to work,
105 but may need more testing before it's placed in the gate. The source
106 just really needs to be here.
107
108 cstyle
|
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 #
22 # Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
23 #
24 # Copyright 2019 Joyent, Inc.
25 #
26
27
28 This directory contains the tools used to do a full build of the
29 OS/Net workspace. They usually live in the /opt/onbld directory on build
30 machines. From here, 'make install' will build and install the tools
31 in $ROOT/opt/onbld.
32
33 Layout of /opt/onbld
34 --------------------
35
36 /opt/onbld/etc/abi
37 contains Solaris ABI database (ABI_*.db) and exceptions
38 for ABI Auditing tool (interface_check, interface_cmp).
39
40 /opt/onbld/bin
41 basic bin directory - contains scripts.
42
43 /opt/onbld/bin/${MACH}
44 architecture-specific bin directory for binaries.
45
68 used with 'nightly,' and starts a shell with the environment
69 set up the same way as 'nightly' set it up. This is useful
70 if you're trying to quickly rebuild portions of a workspace
71 built by 'nightly'. 'ws' should not be used for this since it
72 sets the environment up differently and may cause everything
73 to rebuild (because of different -I or -L paths).
74
75 build_cscope
76 builds cscope databases in the uts, the platform subdirectories
77 of uts, and in usr/src. Uses cscope-fast.
78
79 check_rtime
80 checks ELF attributes used by ELF dynamic objects in the proto area.
81 Used by 'nightly's -r option, to check a number of ELF runtime
82 attributes for consistency with common build rules. nightly uses
83 the -o option to simplify the output for diffing with previous
84 build results. It also uses the -i option to obtain NEEDED and RUNPATH
85 entries, which help detect changes in software dependencies and makes
86 sure objects don't have any strange runpaths like /opt/SUNWspro/lib.
87
88 codesign
89 Tools for signing cryptographic modules using the official
90 Sun release keys stored on a remote signing server. This
91 directory contains signit, a client program for signing
92 files with the signing server; signproto, a shell script
93 that finds crypto modules in $ROOT and signs them using
94 signit; and codesign_server.pl, the code that runs on the
95 server. The codesign_server code is not used on an ON
96 build machine but is kept here for source control purposes.
97
98 copyrightchk
99 Checks that files have appropriate SMI copyright notices.
100 Primarily used by wx
101
102 cscope-fast
103 The fast version of cscope that we use internally. Seems to work,
104 but may need more testing before it's placed in the gate. The source
105 just really needs to be here.
106
107 cstyle
|