1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2014 OmniTI Computer Consulting, Inc. All rights reserved.
  13 .\"
  14 
  15 .TH ZMAKE 1 "11 November 2014"
  16 .SH NAME
  17 .I zmake
  18 \- Build just the OpenZFS bits of an illumos code repository
  19 .SH SYNOPSIS
  20 .B /opt/onbld/bin/zmake [directory]
  21 .LP
  22 .SH DESCRIPTION
  23 
  24 .LP
  25 The \fBzmake\fR command either runs under \fBbldenv(1)\fR or take a directory
  26 path to an illumos source tree.  It builds just the components of illumos
  27 that comprise the OpenZFS implementation.  This command is intended for
  28 OpenZFS developers from non-illumos platforms to confirm that their changes
  29 build on illumos without having to resort to a full \fBnightly(1)\fR build.
  30 .sp
  31 Unlike \fBnightly(1)\fR, zmake does not require ALL of the supplemental
  32 packages a full illumos build needs.  It does, however, requires a subset of
  33 them. This subset is:
  34 
  35 .TS
  36 
  37 Default C compiler (currently gcc4.4.4)
  38 
  39 Sun Studio 12.1 (for lint)
  40 
  41 The OS/Net build tools (onbld)
  42 
  43 An SCM (currently git)
  44 
  45 The object-file tools
  46 
  47 The system headers
  48 
  49 The XML parser for Perl.
  50 
  51 .TE
  52 
  53 .LP
  54 If the required packages are installed (via your distribution's mechanisms),
  55 this command will build the set of packages required to confirm OpenZFS builds.
  56 .sp
  57 .LP
  58 
  59 .SH ENVIRONMENT
  60 .LP
  61 This command prefers to have two environment variables set prior to running,
  62 because they are variable across distributions:
  63 
  64 .TS
  65 
  66 \fBSPRO_ROOT\fR The root directory of the Sun Studio tools.
  67 
  68 \fBGCC_ROOT\fR  The root directory for the GNU C compiler safe for illumos builds.
  69 
  70 .TE
  71 
  72 .LP
  73 
  74 .SH SEE ALSO
  75 .LP
  76 .IR bldenv(1),
  77 .IR nightly(1)
  78 .LP