[prev in list] [next in list] [prev in thread] [next in thread] 

List:       opensolaris-install-discuss
Subject:    [install-discuss] Flag Day: pkg(5) pkgsend changes
From:       Shawn Walker <shawn.walker () oracle ! com>
Date:       2011-07-11 19:59:17
Message-ID: 4E1B5615.6030708 () oracle ! com
[Download RAW message or body]

Greetings,

As of changeset 2456 in the pkg(5) gate, pkgsend(1) now only documents 
support for the 'generate' and 'publish' subcommands, and the 'publish' 
subcommand defaults to --fmri-in-manifest and no longer accepts an FMRI 
argument.

======================================================================
What changed?
======================================================================
Previously, pkgsend(1) had a number of subcommands for supporting 
action-by-action publication such as 'open', 'close', 'include', 
'import', and 'abandon'.

All references to these subcommands have been removed from the man page, 
although they continue to be supported for now.  However, if you are 
relying on them, be aware that they are planned for removal at a later, 
future date.

The 'generate' and 'publish' subcommands now provide complete equivalent 
functionality, so there should be no need for use of the now 
undocumented ones.

The 'publish' subcommand has been changed incompatibly.  Previously, it 
accepted an FMRI for packages on the command line or inside package 
manifests when using the option --fmri-in-manifest.  It now only accepts 
FMRIs specified inside a manifest and any operand to publish is treated 
as the path to a manifest.  The --fmri-in-manifest option is now 
deprecated, although it is still accepted for compatibility purposes.

Finally, pkgsend(1) has been significantly simplified and updated.

======================================================================
How could this change impact me?
======================================================================
Any project currently relying on the no longer documented (and now 
deprecated) subcommands 'open', 'include', 'close', 'abandon', and 
import, should start using 'generate' and 'publish' instead.  See 
pkgsend(1) for information on their usage.

Any project using the --fmri-in-manifest option can safely remove use of 
that option as that is now the only available behaviour.  The old option 
is still accepted for compatibility for now.

======================================================================
What are the related bug entries?
======================================================================

 From defect.opensolaris.org:

   9809 pkgsend publish should take bundle files as sources for files
   13480 pkgsend should check user input before starting operations
   16707 pkg.size is not recomputed during publication
   16816 pkgsend should drop signatures and warn
   17767 pkgsend should gracefully handle pipe errors (interrupted
         input/output)
   18048 pkgsend publish should assume --fmri-in-manifest by default
   18181 pkgsend(1) could be clearer about manifest arguments to publish
   18454 pkgsend(1) could be clearer about -s taking non-URI file paths
   18527 pkgsend manpage example has publish subcommand in wrong location
   18582 pkgsend(1) should not document action-by-action publication
         operations
   18678 pkgsend can traceback on permission errors when using bundle
         files
   18681 pkgsend generate output broken when using trailing slash

-Shawn
_______________________________________________
install-discuss mailing list
install-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/install-discuss
[prev in list] [next in list] [prev in thread] [next in thread]