From RTSC-Pedia

Jump to: navigation, search
revision tip
—— LANDSCAPE orientation
[printable version]  [offline version]offline version generated on 04-Aug-2010 21:08 UTC

Command - xdclpf

Package file list command

Contents

Synopsis

xdclpf [-help] [-a] base_dir ...

Description

The xdclpf command is used to list all files contained in specified packages, one file per line. Since packages can be nested, standard commands such as find and ls are unable to eliminate files that belong to other packages.

File names output by xdclpf are always relative to a package path containing the package's repository. For example, if the current working directory is the base of the xdc.runtime package (say /home/user/xdctools_3_15_00_14/packages/xdc/runtime), all file names displayed by the following commands are identical and begin with "xdc/runtime/".

% xdclpf .
xdc/runtime/package.xdc
    :
% xdclpf ../runtime
xdc/runtime/package.xdc
    :

Options

-a
exclude all packages under the specified package base. Without this flag only packages with the same repository are excluded.
-help
display usage information

Examples

The following command will output all files that are part of the package whose base directory is the current working directory.

% xdcpkg .

To create a "development snapshot" of a package, named my.pkg, which can be easily exchanged between developers:

% xdclpf ./my/pkg > list
% tar czf my_pkg.tar.gz -T list

To compare the manifests of two versions of the same package:

% xdclpf old/my/pkg | sort > old_list
% xdclpf new/my/pkg | sort > new_list
% diff old_list new_list

To check that a new version of a package can safely be placed ahead of an old version on a single package path (i.e., all files in the old version appear in the new version):

% xdclpf old/my/pkg | sort > olist
% xdclpf new/my/pkg | sort > nlist
% cat nlist nlist olist | sort | uniq -u

Exit Status

The following exit values are returned:

  • 0 Successful completion.
  • > 0 An error occurred.
[printable version]  [offline version]offline version generated on 04-Aug-2010 21:08 UTC
Copyright © 2008 The Eclipse Foundation. All Rights Reserved
Views
Personal tools
package reference