User Commands                                            pkgrecv(1)


NAME
     pkgrecv - image packaging system content retrieval utility

SYNOPSIS
     /usr/bin/pkgrecv [-k] [-d directory] -s repouri pkg...

     /usr/bin/pkgrecv -s repouri -n

DESCRIPTION
     pkgrecv allows the user to download the contents of a package
     from a pkg(5) repository.  With the default options, the contents
     are retrieved in a format that can easily be input to pkgsend(1)
     when used with the 'include' subcommand.  As a result, pkgrecv(1)
     and pkgsend(1) can be used to conveniently modify and republish
     packages, perhaps by correcting file contents or providing
     additional package tags.

OPTIONS
     The following options are supported:

     -s repouri    The location of the pkg(5) repository.

     -k             Keep the individual package contents compressed.

     -d directory   The directory where package content should be
                    placed.  The default location is the current working
                    directory.

     -n             Instead of downloading package contents, list the
                    most recent versions of the packages available from
                    the specified repository.

EXAMPLES
     Example 1:  List newest packages available from the repository on
     the system named 'test'.

     $ pkgrecv -s http:/test -n
     pkg:/SUNWlibC@0.5.11,5.11-0.79:20080221T125720Z
     pkg:/SUNWfreetype2@0.5.11,5.11-0.79:20080221T123955Z
     pkg:/SUNWlibm@0.5.11,5.11-0.79:20080221T125728Z
     pkg:/SUNWliboil@0.5.11,5.11-0.79:20080221T125730Z

     Example 2: Receive the SUNWlibC, SUNWfreetype, and SUNWlibm
     packages from example 1.

     $ pkgrecv -s http:/test SUNWlibC@0.5.11,5.11-0.79:20080221T125720Z
     SUNWfreetype2@0.5.11,5.11-0.79:20080221T123955Z
     SUNWlibm@0.5.11,5.11-0.79:20080221T125728Z
     $ ls -d SUNW*
     SUNWfreetype2  SUNWlibC       SUNWlibm

EXIT STATUS
     The following exit values are returned:

     0     Everything worked.

     1     Something bad happened.

     2     Invalid command line options were specified.

FILES

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                                             
    

SEE ALSO
     pkgsend(1), attributes(5), pkg(5)

NOTES
     The image packaging system is an under-development feature.
     Command names, invocation, formats, and operations are all subject
     to change.  Development is hosted in the OpenSolaris community
     at

     http:/opensolaris.org/os/project/pkg/