1 .\" CDDL HEADER START
   2 .\"
   3 .\" The contents of this file are subject to the terms of the
   4 .\" Common Development and Distribution License (the "License").
   5 .\" You may not use this file except in compliance with the License.
   6 .\"
   7 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   8 .\" or http://www.opensolaris.org/os/licensing.
   9 .\" See the License for the specific language governing permissions
  10 .\" and limitations under the License.
  11 .\"
  12 .\" When distributing Covered Code, include this CDDL HEADER in each
  13 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  14 .\" If applicable, add the following below this CDDL HEADER, with the
  15 .\" fields enclosed by brackets "[]" replaced with your own identifying
  16 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  17 .\"
  18 .\" CDDL HEADER END
  19 .\"
  20 .\" Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
  21 .\" Use is subject to license terms.
  22 .\"
  23 .TH cddlchk 1 "1 June 2008"
  24 .SH NAME
  25 cddlchk \- Check for valid CDDL header blocks
  26 .SH SYNOPSIS
  27 .nf
  28 \fBcddlchk \fR [\fB-av\fR] [\fB-x\fR \fIexceptions_file\fR] [\fIpath\fR...]
  29 .fi
  30 .LP
  31 .SH DESCRIPTION
  32 .IX "OS-Net build tools" "cddlchk" "" "\fBcddlchk\fP"
  33 cddlchk inspects files for missing, obsolete, or corrupt Common
  34 Development and Distribution License (CDDL) header blocks.
  35 .LP
  36 .SH OPTIONS
  37 .LP
  38 .TP 4
  39 .B \-a
  40 Check that all the specified files have a CDDL block, and report a
  41 warning if any do not.
  42 If this flag is not specified, only files containing an existing CDDL
  43 block are validated.
  44 .LP
  45 .TP 4
  46 .B \-v
  47 Report on all files, not just those with invalid headers
  48 .LP
  49 .TP 4
  50 .B \-x \fIexceptions_file\fR
  51 Load an exceptions file containing a list of files, directories and
  52 file extensions to be ignored.
  53 Exceptions may be one of three types:
  54 .RS +4
  55 .TP
  56 .ie t \(bu
  57 .el o
  58 File paths
  59 .RE
  60 .RS +4
  61 .TP
  62 .ie t \(bu
  63 .el o
  64 Directories, specified with a trailing '/'
  65 .RE
  66 .RS +4
  67 .TP
  68 .ie t \(bu
  69 .el o
  70 File extensions, specified with a leading '*.'
  71 .RE
  72 .LP
  73 .SH EXIT STATUS
  74 .TP 4
  75 .B 0
  76 The command completed successfully.
  77 No errors or warnings were reported
  78 .LP
  79 .TP 4
  80 .B 1
  81 The command completed unsuccessfully.
  82 One or more errors or warnings were reported.
  83 .LP
  84 .TP 4
  85 .B 2
  86 Invalid command-line arguments were specified to the command.