README
author Richard Lowe <richlowe@richlowe.net>
Tue, 02 Oct 2012 05:18:23 +0100
changeset 13878 91dbcb77a2f9
parent 13187 36a51d4e554c
child 13896 8e4bcbc31a4a
permissions -rw-r--r--
3150 poll times out immediately in 32bit kernels Reviewed by: Eric Schrock <[email protected]> Reviewed by: Garrett D'Amore <[email protected]> Reviewed by: Gordon Ross <[email protected]> Approved by: Robert Mustacchi <[email protected]>
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     1
illumos gate README - Sept 12, 2010.
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
     2
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     3
This is the illumos gate.  This is the illumos source tree.  It contains
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     4
the following subdirectories:
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
     5
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     6
	usr/src	- 		The actual source code
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
     7
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     8
	exception_lists	-	These are lists of exceptional cases
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
     9
				used to limit noise during builds.
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    10
				Ideally this directory would consist of
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    11
				only empty files.
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    12
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    13
Integration Rules:
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    14
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    15
        All changes must have been reviewed, and approved by and advocate
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    16
	(below).  A code review may be performed by someone other than the
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    17
	advocate, but the final integration should still be approved by the
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    18
	advocate. 
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    19
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    20
        The advocate will want to see your webrev and hg outgoing -v.  The
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    21
	advocate will also ask about your testing, and may ask to see your
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    22
	build logs.
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    23
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    24
        All changes must adhere to typical ON style and quality rules.
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    25
        For example, pass full cstyle, applicable lint rules, etc.
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    26
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    27
        All commits must include either a CDDL license, unless
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    28
        approved otherwise by the gatekeeper, or the modified code
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    29
	already carries a different license.  Exceptions shall require
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    30
	the approval of the gatekeeper.
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    31
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    32
        Hg commits should have comments of the following form:
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    33
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    34
        1234 This is a sample bug report synopsis
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    35
        4567 If you have a second bug synopsis...
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    36
        Reviewed by: [email protected]
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    37
        Approved by: [email protected]
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    38
13187
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    39
	Each commit must have at least one bug id that is listed in the
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    40
	illumos-gate project at www.illumos.org.
36a51d4e554c 188 should keep unused closed-bins out of the proto area
Garrett D'Amore <garrett@nexenta.com>
parents: 12780
diff changeset
    41
12780
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    42
Branches:
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    43
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    44
        Please talk to the gatekeeper about personal branches.  In general,
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    45
        they will be allowed as long as we don't go *too* wild on them.
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    46
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    47
Gatekeeper:     [email protected]  (Interim)
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    48
IRC channel:    #illumos on irc.freenode.net
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    49
Mailing list:   [email protected]
c39281da15f8 1 Need README & TODO for Illumos project
Garrett D'Amore <garrett@nexenta.com>
parents:
diff changeset
    50