Subversion Repositories DevTools

Rev

Rev 243 | Rev 263 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 243 Rev 255
Line 15... Line 15...
15 
#                   Bad Packages
 15 
#                   Bad Packages
16 
#
 16 
#
17 
#
 17 
#
18 
#......................................................................#
 18 
#......................................................................#
19 
 
 19 
 
20 
require 5.6.1;
 20 
require 5.006_001;
21 
use strict;
 21 
use strict;
22 
use warnings;
 22 
use warnings;
23 
use JatsEnv;
 23 
use JatsEnv;
24 
use JatsError;
 24 
use JatsError;
25 
use JatsSystem;
 25 
use JatsSystem;
Line 1654... Line 1654...
1654 
    -help              - brief help message
 1654 
    -help              - brief help message
1655 
    -help -help        - Detailed help message
 1655 
    -help -help        - Detailed help message
1656 
    -man               - Full documentation
 1656 
    -man               - Full documentation
1657 
    -sbomid=xxx        - Specify the SBOM to process
 1657 
    -sbomid=xxx        - Specify the SBOM to process
1658 
    -rtagid=xxx        - Specify the Release to process (Optional)
 1658 
    -rtagid=xxx        - Specify the Release to process (Optional)
- 
 
 1659 
    -rootpackage=xxx   - Specifies a root package. In conjunction with -rtagid.
1659 
    -ignore=name       - Ignore packages with the specified name
 1660 
    -ignore=name       - Ignore packages with the specified name
1660 
    -extract=fname     - Extract files from a previous run
 1661 
    -extract=fname     - Extract files from a previous run
1661 
    -verbose           - Enable verbose output
 1662 
    -verbose           - Enable verbose output
1662 
    -[no]patch         - Ignore/Include patches. Default:Include
 1663 
    -[no]patch         - Ignore/Include patches. Default:Include
1663 
    -[no]test          - Reduced package scanning for test
 1664 
    -[no]test          - Reduced package scanning for test
Line 1678... Line 1679...
1678 
 
 1679 
 
1679 
Prints the manual page and exits.
 1680 
Prints the manual page and exits.
1680 
 
 1681 
 
1681 
=item B<-sbomid=xxx>
 1682 
=item B<-sbomid=xxx>
1682 
 
 1683 
 
1683 
This option is mandatory. It specifies the SBOM to process. The sbomid must be
 1684 
This option specifies the SBOM to process. The sbomid must be determined from
1684 
determined from Deployment Manager.
 1685 
Deployment Manager.
1685 
 
 1686 
 
1686 
=item B<-rtagid=xxx>
 1687 
=item B<-rtagid=xxx>
1687 
 
 1688 
 
- 
 
 1689 
This option specified an RTAG_ID that must be determined from Release Manager.
- 
 
 1690 
 
- 
 
 1691 
This option may be used with or without the B<-sbomid=xxx> option.
- 
 
 1692 
 
1688 
If provided, this option specifies an RTAG_ID to process in conjunction with the SBOM.
 1693 
With an SBOM_ID this option specifies an RTAG_ID to process in conjunction with the SBOM.
1689 
The RTAG_ID must be determined from Release Manager. The program will determine
 1694 
The program will determine packages that are in the Release, but not in the
- 
 
 1695 
SBOM.
- 
 
 1696 
 
- 
 
 1697 
Without an SBOM_ID, this option will limit the processing to the specified
1690 
packages that are in th Release, but not in the SBOM.
 1698 
release. Less information is generated. This form of the generation may be
- 
 
 1699 
combined with B<-rootpackage=xxx> to further limit the set of packages
- 
 
 1700 
processed.
- 
 
 1701 
 
- 
 
 1702 
=item B<-rootpackage=xxx>
- 
 
 1703 
 
- 
 
 1704 
This option can be used in conjunction with B<-rtagid=xxx> to limit the
- 
 
 1705 
extraction to named package and all of its dependent packages. The tool will
- 
 
 1706 
determine the required version of the package via the specified release.
1691 
 
 1707 
 
1692 
=item B<-ignore=name>
 1708 
=item B<-ignore=name>
1693 
 
 1709 
 
1694 
All versions of the named package will be ignored. This parameter is options.
 1710 
All versions of the named package will be ignored. This parameter is options.
1695 
It may be used multiple times.
 1711 
It may be used multiple times.
Line 1700... Line 1716...
1700 
program and extract source files for the package-versions found in the file.
 1716 
program and extract source files for the package-versions found in the file.
1701 
 
 1717 
 
1702 
The command will then create a log file recording packages that could ne be
 1718 
The command will then create a log file recording packages that could ne be
1703 
extracted.
 1719 
extracted.
1704 
 
 1720 
 
1705 
This option cannot be used in conjunction wit the -rtagid or -sbomid.
 1721 
This option cannot be used in conjunction with the -rtagid or -sbomid.
1706 
 
 1722 
 
1707 
=item B<-[no]patch>
 1723 
=item B<-[no]patch>
1708 
 
 1724 
 
1709 
This option is used ignore patches. If -nopatch is selected, then packages
 1725 
This option is used ignore patches. If -nopatch is selected, then packages
1710 
versions that look like a patch will be added to the ignore list.
 1726 
versions that look like a patch will be added to the ignore list.
Line 1713... Line 1729...
1713 
 
 1729 
 
1714 
This option is used for testing. It will only process the first two OS entries
 1730 
This option is used for testing. It will only process the first two OS entries
1715 
in the SBOM. This speeds up processing. It does not generate a complete list of
 1731 
in the SBOM. This speeds up processing. It does not generate a complete list of
1716 
packages.
 1732 
packages.
1717 
 
 1733 
 
1718 
=item B<verbose>
 1734 
=item B<-verbose>
1719 
 
 1735 
 
1720 
This option will display progress information as the program executes.
 1736 
This option will display progress information as the program executes.
1721 
 
 1737 
 
1722 
=back
 1738 
=back
1723 
 
 1739 
 
1724 
=head1 DESCRIPTION
 1740 
=head1 DESCRIPTION
1725 
 
 1741 
 
1726 
This program is a tool for extracting Escrow build information.
 1742 
This program is a tool for extracting Escrow build information.
- 
 
 1743 
The program has two modes of operation:
- 
 
 1744 
 
- 
 
 1745 
=over 8
1727 
 
 1746 
 
- 
 
 1747 
=item 1. Generation. Generate files describing packages within an SBOM/Release.
- 
 
 1748 
 
- 
 
 1749 
=item 2. Extraction  Supervise extraction of source trees.
- 
 
 1750 
 
- 
 
 1751 
=back
- 
 
 1752 
 
- 
 
 1753 
=head2 Generation Operations
- 
 
 1754 
 
1728 
Given an SBOM_ID this program will:
 1755 
Given an SBOM_ID and/or RTAG_ID this program will:
1729 
 
 1756 
 
1730 
=over 8
 1757 
=over 8
1731 
 
 1758 
 
1732 
=item * Determine all the NODES in the SBOM
 1759 
=item * Determine all the NODES in the SBOM
1733 
 
 1760 
 
Line 1759... Line 1786...
1759 
 
 1786 
 
1760 
=item * Build order
 1787 
=item * Build order
1761 
 
 1788 
 
1762 
=item * Build machines and built types
 1789 
=item * Build machines and built types
1763 
 
 1790 
 
1764 
=item * Deployed target nodes, with references into deployment manager
 1791 
=item * Deployed target nodes, with references into Deployment Manager
1765 
 
 1792 
 
1766 
=back
 1793 
=back
1767 
 
 1794 
 
1768 
=back
 1795 
=back
1769 
 
 1796 
 
1770 
This may take some time, as a typical escrow build may contain many hundreds of packages.
 1797 
This may take some time, as a typical escrow build may contain many hundreds of packages.
1771 
 
 1798 
 
1772 
The program will display a list of files that have been created.
 1799 
The program will display a list of files that have been created.
1773 
 
 1800 
 
- 
 
 1801 
=head2 Extraction Operations
- 
 
 1802 
 
1774 
Given an 'extract' file from a previous run of this program the program will:
 1803 
Given an 'extract' file from a previous run of this program the program will:
1775 
 
 1804 
 
1776 
=over 8
 1805 
=over 8
1777 
 
 1806 
 
1778 
=item * Parse the 'extract' file
 1807 
=item * Parse the 'extract' file
1779 
 
 1808 
 
1780 
=item * Create subdirectoroes for each package version within the file. This is done
 1809 
=item * Create subdirectories for each package version within the file. This is done
1781 
in such a way that no views are left in place.
 1810 
in such a way that no views are left in place.
1782 
 
 1811 
 
1783 
=item * Create a log file showing packages that could not be extracted.
 1812 
=item * Create a log file showing packages that could not be extracted.
1784 
 
 1813 
 
1785 
 
 - 
 
1786 
=back
 1814 
=back
1787 
 
 1815 
 
1788 
=cut
 1816 
=cut
1789 
 
 1817