README.rdoc

solaris-patch¶ ↑

Author

Martin Carpenter

Email

[email protected]

Copyright

Copyright © Martin Carpenter 2011

About¶ ↑

The solaris-patch gem helps with the manipulation of SunOS and Solaris patches.

• Read (or write!) patchdiag.xref files.

• Find latest version of a patch.

• Find latest non-superseded version of a patch.

• Download patchdiag.xref, patches, readmes from Oracle.

• …

Examples¶ ↑

Download a patch¶ ↑

require 'solaris/patch'
Solaris::Patch.download_patch!('123456-78',
                               :to_file => '/tmp/123456-78.zip')

Alternatively:

patch = Solaris::Patch.new('123456-78')
patch.download_patch!(:to_dir => '/tmp')

Download a readme¶ ↑

require 'solaris/patch'
Solaris::Patch.download_readme!('123456-78',
                                :to_file => '/tmp/123456-78.txt')

Get the latest version of a patch¶ ↑

require 'solaris/patch'
Solaris::Patchdiag.open('/tmp/patchdiag.xref').latest('123456-01')
=> "123456|12|..."

Get the latest non-obsolete version of a possibly obsoleted patch¶ ↑

require 'solaris/patch'
Solaris::Patchdiag.open('/tmp/patchdiag.xref').successor('123456-01')
=> "234567|12|..."

Interrogate patchdiag.xref¶ ↑

require 'solaris/patch'

# slurp in patchdiag.xref
patchdiag = Solaris::Patchdiag.new('/tmp/patchdiag.xref')

# all sparc patches
patchdiag.select { |p| p.archs.include? 'sparc' }.inspect
=> ["123456-78", ...]

# latest line added to patchdiag.xref
most_recent = patchdiag.sort_by(&:date).last
most_recent
=> "123456|78|..."

# most recent patch number
most_recent.patch
=> "123456-78"

# most recent patch's README if it was recommended
most_recent.download_readme! if most_recent.recommended?
=> "Patch-ID# 123456-78..."

Known issues¶ ↑

Dates in patchdiag.xref are Mon/dd/yy format. This gem will break in 2050 since it assumes year 50 and above is in the 20th century.