usr/src/tools/depcheck/get_depend_info.1onbld

   1 '\" t
   2 .\"
   3 .\" CDDL HEADER START
   4 .\"
   5 .\" The contents of this file are subject to the terms of the
   6 .\" Common Development and Distribution License, Version 1.0 only
   7 .\" (the "License").  You may not use this file except in compliance
   8 .\" with the License.
   9 .\"
  10 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  11 .\" or http://www.opensolaris.org/os/licensing.
  12 .\" See the License for the specific language governing permissions
  13 .\" and limitations under the License.
  14 .\"
  15 .\" When distributing Covered Code, include this CDDL HEADER in each
  16 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  17 .\" If applicable, add the following below this CDDL HEADER, with the
  18 .\" fields enclosed by brackets "[]" replaced with your own identifying
  19 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  20 .\"
  21 .\" CDDL HEADER END
  22 .\"
  23 .\"
  24 .\" Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved.
  25 .\" Use is subject to license terms.
  26 .\"
  27 .TH GET_DEPEND_INFO 1ONBLD "Nov 2, 2000"
  28 .SH "NAME"
  29 get_depend_info \- get dependency information about a package or a file
  30 .SH "SYNOPSIS"
  31 .PP
  32 .nf
  33 \fBget_depend_info\fR [-\fBcons\fR] \-\fBdbdir\fR \fIdbm_database_pathname\fR
  34                 [-\fBf\fR | -\fBp\fR] [-\fBh\fR] [-\fBroot\fR \fIroot_pathname\fR]
  35                 [-\fBs\fR] [-\fBpkg\fR \fISUN_package\fR | \fIfilename\fR \&...]
  36 .fi
  37 .SH "DESCRIPTION"
  38 .PP
  39 The \fBget_depend_info\fR command prints dependency information about a package,
  40 a file, or a set of files on the standard output\&.
  41 .SH "OPTIONS"
  42 .PP
  43 The following options are supported:
  44 .sp
  45 .ne 2
  46 \fB-\fBcons\fR\fR
  47 .in +16n
  48 Turns on conservative mode, that is, refrains from using
  49 \fB/usr/bin/strings\fR\&.
  50 .sp
  51 .sp 1
  52 .in -16n
  53 .sp
  54 .ne 2
  55 \fB-\fBdbdir\fR\fR
  56 .in +16n
  57 Specifies the directory in which the Perl DBM databases generated by
  58 \fBmake_pkg_db\fR(1ONBLD) are located\&.
  59 .sp
  60 .sp 1
  61 .in -16n
  62 .sp
  63 .ne 2
  64 \fB-\fBf\fR\fR
  65 .in +16n
  66 Outputs file dependencies only\&.
  67 .sp
  68 .sp 1
  69 .in -16n
  70 .sp
  71 .ne 2
  72 \fB-\fBh\fR\fR
  73 .in +16n
  74 Displays help\&.
  75 .sp
  76 .sp 1
  77 .in -16n
  78 .sp
  79 .ne 2
  80 \fB-\fBp\fR\fR
  81 .in +16n
  82 Outputs package dependencies only\&.
  83 .sp
  84 .sp 1
  85 .in -16n
  86 .sp
  87 .ne 2
  88 \fB-\fBpkg\fR\fR
  89 .in +16n
  90 Specifies a particular package on which you want to run the dependency
  91 analysis\&. You must specify this option if you specify either a Sun software
  92 package or a third-party software package that conforms with the Sun package
  93 format (\fISUN_package\fR)\&.
  94 .sp
  95 .sp 1
  96 .in -16n
  97 .sp
  98 .ne 2
  99 \fB-\fBroot\fR\fR
 100 .in +16n
 101 Specifies an alternate root\&. You must also use the -\fBpkg\fR option if you
 102 use this option\&.
 103 .sp
 104 .sp 1
 105 .in -16n
 106 .sp
 107 .ne 2
 108 \fB-\fBs\fR\fR
 109 .in +16n
 110 Outputs symbolic links for files or packages only\&.
 111 .sp
 112 .sp 1
 113 .in -16n
 114 .SH "OPERANDS"
 115 .PP
 116 The following operands are supported:
 117 .sp
 118 .ne 2
 119 \fB\fIdbm_database_pathname\fR\fR
 120 .in +24n
 121 Specifies the path name of the directory in which the Perl DBM databases
 122 generated by \fBmake_pkg_db\fR are located\&.
 123 .sp
 124 .sp 1
 125 .in -24n
 126 .sp
 127 .ne 2
 128 \fB\fIfilename\fR\fR
 129 .in +24n
 130 Specifies the name of a file or files on which you want to run the dependency
 131 analysis\&.
 132 .sp
 133 .sp 1
 134 .in -24n
 135 .sp
 136 .ne 2
 137 \fB\fIroot_pathname\fR\fR
 138 .in +24n
 139 Specifies the path name of an alternate root you want to use\&.
 140 .sp
 141 .sp 1
 142 .in -24n
 143 .sp
 144 .ne 2
 145 \fB\fISUN_package\fR\fR
 146 .in +24n
 147 Specifies the name of a particular Sun software package (or any third-party
 148 software package that conforms with the Sun package format) on which you want
 149 to run the dependency analysis\&. You must use the -\fBpkg\fR option if you
 150 specify this operand\&.
 151 .sp
 152 .sp 1
 153 .in -24n
 154 .PP
 155 You can specify either a Sun software package or a file name, but not both\&.
 156 .SH "EXAMPLES"
 157 .PP
 158 \fBExample 1:\fR To Get a Dependency Analysis of Two Particular Files
 159 .PP
 160 .nf
 161 % get_depend_info -dbdir MyDir /usr/bin/ls /usr/bin/man
 162 .fi
 163 .PP
 164 \fBExample 2:\fR To Get a Dependency Analysis of Files Using a Wild Card
 165 .PP
 166 .nf
 167 % get_depend_info -dbdir MyDir /usr/sbin/*
 168 .fi
 169 .PP
 170 \fBExample 3:\fR To Get a Dependency Analysis of a Package in Sun Format
 171 .PP
 172 .nf
 173 % get_depend_info -dbdir MyDir -pkg NSCPcom
 174 % get_depend_info -dbdir MyDir -pkg SUNWnisu
 175 .fi
 176 .PP
 177 \fBExample 4:\fR To Display Help
 178 .PP
 179 .nf
 180 % get_depend_info -h
 181 .fi
 182 .SH "ATTRIBUTES"
 183 .PP
 184 See \fBattributes\fR(5) for descriptions of the following attributes:
 185 .sp
 186 .TS
 187 box;
 188 c | c
 189 l | l .
 190 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 191 _
 192 Availability    SUNWonbld
 193 CSI     Enabled
 194 Interface Stability     Evolving
 195 MT-Level        Unsafe
 196 .TE
 197 .sp
 198 .SH "SEE ALSO"
 199 .PP
 200 \fBmake_pkg_db\fR(1ONBLD), \fBattributes\fR(5)