OpenSolaris_b135/tools/depcheck/get_depend_info.1

.\" ident	"%Z%%M%	%I%	%E% SMI"
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1997, v.4001-->
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen nbsp>
<?Pub Inc>
<refentry id="get-depend-info-1"><?Pub Caret1>
<!-- GENERIC CmdSynopsis TEMPLATE      @(#)man1_template.sgm 1.6 97/09/23 SMI; -->
<refmeta><refentrytitle>get_depend_info</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">2 November 2000</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">
Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
Use is subject to license terms.

CDDL HEADER START

The contents of this file are subject to the terms of the
Common Development and Distribution License, Version 1.0 only
(the "License").  You may not use this file except in compliance
with the License.

You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.

When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]

CDDL HEADER END
</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary sortas="blueprint">get_depend_info &mdash; get dependency information about a package or a file</primary></indexterm><indexterm><primary sortas="get dependency information about a package or a file">get dependency information about a package or a file &mdash; get_depend_info</primary></indexterm><refname>get_depend_info</refname><refpurpose>get dependency information about a package or a file</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>get_depend_info</command><arg choice="opt"><option>cons</option></arg><arg choice="plain"><option>dbdir</option> <replaceable>dbm_database_pathname</replaceable>&nbsp;</arg><group><arg choice="plain"><option>f</option></arg><arg choice="plain"><option>p</option></arg></group><arg choice="opt"><option>h</option></arg><arg choice="opt"><option>root</option> <replaceable>root_pathname</replaceable></arg><arg choice="opt"><option>s</option></arg><group><arg choice="plain"><option>pkg</option> <replaceable>SUN_package</replaceable></arg><arg choice="plain" rep="repeat"><replaceable>filename</replaceable> </arg></group>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>get_depend_info</command> command prints dependency information about a package, a file, or a set of files on the standard output.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="narrow"><varlistentry><term><option>cons</option></term><listitem><para>Turns on conservative mode, that is, refrains from using <filename><?Pub _nolinebreak>/usr/bin/strings<?Pub /_nolinebreak></filename>.</para>
</listitem></varlistentry>
<varlistentry><term><option>dbdir</option></term><listitem><para>Specifies the directory in which the Perl DBM databases generated by <citerefentry><refentrytitle>make_pkg_db</refentrytitle><manvolnum>1</manvolnum></citerefentry> are located.</para>
</listitem></varlistentry>
<varlistentry><term><option>f</option></term><listitem><para>Outputs file dependencies only.</para>
</listitem></varlistentry>
<varlistentry><term><option>h</option></term><listitem><para>Displays help.</para>
</listitem></varlistentry>
<varlistentry><term><option>p</option></term><listitem><para>Outputs package dependencies only.</para>
</listitem></varlistentry>
<varlistentry><term><option>pkg</option></term><listitem><para>Specifies a particular package on which you want to run the dependency analysis. You must specify this option if you specify either a Sun software package or a third-party software package that conforms with the Sun package format (<replaceable>SUN_package</replaceable>).</para>
</listitem></varlistentry>
<varlistentry><term><option>root</option></term><listitem><para>Specifies an alternate root. You must also use the <option>pkg</option> option if you use this option.</para>
</listitem></varlistentry>
<varlistentry><term><option>s</option></term><listitem><para>Outputs symbolic links for files or packages only.</para>
</listitem></varlistentry>
</variablelist>
</refsect1>
<refsect1><title>&oper-tt;</title>
<para>The following operands are supported:</para>
<variablelist termlength="medium"><varlistentry><term><replaceable>dbm_database_pathname</replaceable></term><listitem><para>Specifies the path name of the directory in which the Perl DBM databases generated by <command>make_pkg_db</command> are located.</para>
</listitem></varlistentry>
<varlistentry><term><replaceable>filename</replaceable></term><listitem><para>Specifies the name of a file or files on which you want to run the dependency analysis.</para>
</listitem></varlistentry>
<varlistentry><term><replaceable>root_pathname</replaceable></term><listitem><para>Specifies the path name of an alternate root you want to use.</para>
</listitem></varlistentry>
<varlistentry><term><replaceable>SUN_package</replaceable></term><listitem><para>Specifies the name of a particular Sun software package (or any third-party software package that conforms with the Sun package format) on which you want to run the dependency analysis. You must use the <option>pkg</option> option if you specify this operand.</para>
</listitem></varlistentry>
</variablelist>
<para>You can specify either a Sun software package or a file name, but not both.</para>
</refsect1>
<refsect1><title>&exam-tt;</title>
<example role="example"><title>To Get a Dependency Analysis of Two Particular Files</title>
<para><screen>% <userinput>get_depend_info -dbdir MyDir /usr/bin/ls /usr/bin/man</userinput></screen></para>
</example>
<example role="example"><title>To Get a Dependency Analysis of Files Using a Wild Card</title>
<para><screen>% <userinput>get_depend_info -dbdir MyDir /usr/sbin/*</userinput></screen></para>
</example>
<example role="example"><title>To Get a Dependency Analysis of a Package in Sun Format</title>
<para><screen>% <userinput>get_depend_info -dbdir MyDir -pkg NSCPcom</userinput>
% <userinput>get_depend_info -dbdir MyDir -pkg SUNWnisu</userinput></screen></para>
</example>
<example role="example"><title>To Display Help</title>
<para><screen>% <userinput>get_depend_info -h</userinput></screen></para>
</example>
</refsect1>
<refsect1><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink> for descriptions of the following attributes:</para>
<informaltable frame="all"><tgroup cols="2" colsep="1" rowsep="1"><colspec colwidth="198*"><colspec colwidth="198*"><tbody><row><entry align="left" valign="top">ATTRIBUTE TYPE</entry><entry align="left" valign="top">ATTRIBUTE VALUE</entry></row><row><entry align="left" valign="top">Availability</entry><entry align="left" valign="top">SUNWonbld</entry></row><row><entry align="left" valign="top">CSI</entry><entry align="left" valign="top">Enabled</entry></row><row><entry align="left" valign="top">Interface Stability</entry><entry align="left" valign="top">Evolving</entry></row><row><entry align="left" valign="top">MT-Level</entry><entry align="left" valign="top">Unsafe</entry></row></tbody></tgroup></informaltable>
</refsect1>
<refsect1><title>&also-tt;</title>
<para><citerefentry><refentrytitle>make_pkg_db</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
</refsect1>
</refentry>
<?Pub *0000007505 480>