tpkg 2.3.3 → 2.3.4

data/lib/tpkg/thirdparty/net-ssh-2.1.0/lib/net/ssh/verifiers/lenient.rb

@@ -0,0 +1,30 @@
+require 'net/ssh/verifiers/strict'
+
+module Net; module SSH; module Verifiers
+
+  # Basically the same as the Strict verifier, but does not try to actually
+  # verify a connection if the server is the localhost and the port is a
+  # nonstandard port number. Those two conditions will typically mean the
+  # connection is being tunnelled through a forwarded port, so the known-hosts
+  # file will not be helpful (in general).
+  class Lenient < Strict
+    # Tries to determine if the connection is being tunnelled, and if so,
+    # returns true. Otherwise, performs the standard strict verification.
+    def verify(arguments)
+      return true if tunnelled?(arguments)
+      super
+    end
+
+    private
+
+      # A connection is potentially being tunnelled if the port is not 22,
+      # and the ip refers to the localhost.
+      def tunnelled?(args)
+        return false if args[:session].port == Net::SSH::Transport::Session::DEFAULT_PORT
+        
+        ip = args[:session].peer[:ip]
+        return ip == "127.0.0.1" || ip == "::1"
+      end
+  end
+
+end; end; end

data/lib/tpkg/thirdparty/net-ssh-2.1.0/lib/net/ssh/verifiers/null.rb

@@ -0,0 +1,12 @@
+module Net; module SSH; module Verifiers
+
+  # The Null host key verifier simply allows every key it sees, without
+  # bothering to verify. This is simple, but is not particularly secure.
+  class Null
+    # Returns true.
+    def verify(arguments)
+      true
+    end
+  end
+
+end; end; end

data/lib/tpkg/thirdparty/net-ssh-2.1.0/lib/net/ssh/verifiers/strict.rb

@@ -0,0 +1,53 @@
+require 'net/ssh/errors'
+require 'net/ssh/known_hosts'
+
+module Net; module SSH; module Verifiers
+
+  # Does a strict host verification, looking the server up in the known
+  # host files to see if a key has already been seen for this server. If this
+  # server does not appear in any host file, this will silently add the
+  # server. If the server does appear at least once, but the key given does
+  # not match any known for the server, an exception will be raised (HostKeyMismatch).
+  # Otherwise, this returns true.
+  class Strict
+    def verify(arguments)
+      options = arguments[:session].options
+      host = options[:host_key_alias] || arguments[:session].host_as_string
+      matches = Net::SSH::KnownHosts.search_for(host, arguments[:session].options)
+
+      # we've never seen this host before, so just automatically add the key.
+      # not the most secure option (since the first hit might be the one that
+      # is hacked), but since almost nobody actually compares the key
+      # fingerprint, this is a reasonable compromise between usability and
+      # security.
+      if matches.empty?
+        ip = arguments[:session].peer[:ip]
+        Net::SSH::KnownHosts.add(host, arguments[:key], arguments[:session].options)
+        return true
+      end
+
+      # If we found any matches, check to see that the key type and
+      # blob also match.
+      found = matches.any? do |key|
+        key.ssh_type == arguments[:key].ssh_type &&
+        key.to_blob  == arguments[:key].to_blob
+      end
+
+      # If a match was found, return true. Otherwise, raise an exception
+      # indicating that the key was not recognized.
+      found || process_cache_miss(host, arguments)
+    end
+
+    private
+
+      def process_cache_miss(host, args)
+        exception = HostKeyMismatch.new("fingerprint #{args[:fingerprint]} does not match for #{host.inspect}")
+        exception.data = args
+        exception.callback = Proc.new do
+          Net::SSH::KnownHosts.add(host, args[:key], args[:session].options)
+        end
+        raise exception
+      end
+  end
+
+end; end; end

data/lib/tpkg/thirdparty/net-ssh-2.1.0/lib/net/ssh/version.rb

@@ -0,0 +1,62 @@
+module Net; module SSH
+  # A class for describing the current version of a library. The version
+  # consists of three parts: the +major+ number, the +minor+ number, and the
+  # +tiny+ (or +patch+) number.
+  #
+  # Two Version instances may be compared, so that you can test that a version
+  # of a library is what you require:
+  #
+  #   require 'net/ssh/version'
+  #
+  #   if Net::SSH::Version::CURRENT < Net::SSH::Version[2,1,0]
+  #     abort "your software is too old!"
+  #   end
+  class Version
+    include Comparable
+
+    # A convenience method for instantiating a new Version instance with the
+    # given +major+, +minor+, and +tiny+ components.
+    def self.[](major, minor, tiny)
+      new(major, minor, tiny)
+    end
+
+    attr_reader :major, :minor, :tiny
+
+    # Create a new Version object with the given components.
+    def initialize(major, minor, tiny)
+      @major, @minor, @tiny = major, minor, tiny
+    end
+
+    # Compare this version to the given +version+ object.
+    def <=>(version)
+      to_i <=> version.to_i
+    end
+
+    # Converts this version object to a string, where each of the three
+    # version components are joined by the '.' character. E.g., 2.0.0.
+    def to_s
+      @to_s ||= [@major, @minor, @tiny].join(".")
+    end
+
+    # Converts this version to a canonical integer that may be compared
+    # against other version objects.
+    def to_i
+      @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
+    end
+
+    # The major component of this version of the Net::SSH library
+    MAJOR = 2
+
+    # The minor component of this version of the Net::SSH library
+    MINOR = 1
+
+    # The tiny component of this version of the Net::SSH library
+    TINY  = 0
+
+    # The current version of the Net::SSH library as a Version instance
+    CURRENT = new(MAJOR, MINOR, TINY)
+
+    # The current version of the Net::SSH library as a String
+    STRING = CURRENT.to_s
+  end
+end; end

data/lib/tpkg/version.rb

@@ -0,0 +1,3 @@
+class Tpkg
+  VERSION = '2.3.4'
+end

data/man/man1/cpan2tpkg.1

@@ -0,0 +1,82 @@
+.TH cpan2tpkg 1 "January 2011"
+
+.SH NAME
+
+.B cpan2tpkg
+\- Create tpkg packages from Perl CPAN modules
+
+.SH SYNOPSIS
+
+.B cpan2tpkg
+.RB [ --version | \-v
+.IR VERSION ]
+.RB [ --package-version | --pv
+.IR PKGVER ]
+.RB [ --extra-deps
+.IR EXTRADEPS ]
+.RB [ --native-deps
+.IR NATIVEDEPS ]
+.RB [ --force ]
+.RB [ --help | \-h ]
+MODULE
+
+.SH DESCRIPTION
+
+cpan2tpkg is a utility for creating tpkg packages from Perl CPAN modules. If
+the CPAN module being packaged requires other modules those will also be
+packaged and appropriate dependencies inserted into the various tpkgs.
+
+.SH OPTIONS
+.TP
+.BI --version|-v " VERSION"
+Specifies the version of the module to package.  By default the latest version
+of the module will be packaged.
+.TP
+.BI --package-version|--pv " PKGVER"
+The package version to set in the generated tpkg.  By default 
+.I 1
+will be used.  See the tpkg documentation for more information about package
+versions.
+.TP
+.BI --extra-deps " NATIVEDEPS"
+Specify any extra dependencies that should be added to the generated tpkg.
+The dependencies are specified as a comma-separated list with the syntax of
+firstdepname,minver,maxver,seconddepname,minver,maxver,etc.  Minimum and
+maximum versions can be left blank if not required.  The following are all
+valid examples:
+.PP
+.RS
+--extra-deps mysql
+.RS 0
+--extra-deps mysql,,
+.RS 0
+--extra-deps mysql,5.1.33,5.1.35
+.RS 0
+--extra-deps mysql,5.1.33,5.1.35,nginx,0.6,0.6.9999
+.RS 0
+--extra-deps mysql,,,nginx,,
+.RE 1
+.TP
+.BI --native-deps " PACKAGES"
+Specify any native dependencies that should be added to the generated tpkg.
+Syntax is the same as --extra-deps.
+.TP
+.B --force
+Force the install and packaging even if tests fail.  CPAN will normally refuse
+to install modules if their tests fail.  This allows you to package those
+modules anyway.
+.TP
+.BR --help | \-h
+Display the
+.B cpan2tpkg
+usage message and exit.
+
+.SH BUGS
+
+--version is not implemented at this time.
+
+.SH AUTHORS
+
+.B cpan2tpkg
+is designed and maintained by Jason Heiss.
+

data/man/man1/gem2tpkg.1

@@ -0,0 +1,120 @@
+.TH gem2tpkg 1 "January 2011"
+
+.SH NAME
+
+.B gem2tpkg
+\- Create tpkg packages from Ruby gems
+
+.SH SYNOPSIS
+
+.B gem2tpkg
+.RB [ --version | \-v
+.IR VERSION ]
+.RB [ --package-version | --pv
+.IR PKGVER ]
+.RB [ --extra-deps
+.IR EXTRADEPS ]
+.RB [ --native-deps
+.IR NATIVEDEPS ]
+.RB [ --install-options
+.IR INSTALLOPTS ]
+.RB [ --build-options
+.IR BUILDOPTS ]
+.RB [ --gem-cmd
+.IR GEMCMD ]
+.RB [ --rubygems-path
+.IR PATH ]
+.RB [ --extra-name
+.IR EXTRANAME ]
+.RB [ --help | \-h ]
+GEMNAME1 GEMNAME2 ...
+
+.SH DESCRIPTION
+
+gem2tpkg is a utility for creating tpkg packages from Ruby gems. If the gem
+being packaged requires other gems those will also be packaged and appropriate
+dependencies inserted into the various tpkgs.
+
+.SH OPTIONS
+.TP
+.BI --version|-v " VERSION"
+Specifies the version of the gem to package.  By default the latest version of
+the gem will be packaged.
+.TP
+.BI --package-version|--pv " PKGVER"
+The package version to set in the generated tpkg.  By default 
+.I 1
+will be used.  See the tpkg documentation for more information about package
+versions.
+.TP
+.BI --extra-deps " NATIVEDEPS"
+Specify any extra dependencies that should be added to the generated tpkg.
+The dependencies are specified as a comma-separated list with the syntax of
+firstdepname,minver,maxver,seconddepname,minver,maxver,etc.  Minimum and
+maximum versions can be left blank if not required.  The following are all
+valid examples:
+.PP
+.RS
+--extra-deps mysql
+.RS 0
+--extra-deps mysql,,
+.RS 0
+--extra-deps mysql,5.1.33,5.1.35
+.RS 0
+--extra-deps mysql,5.1.33,5.1.35,nginx,0.6,0.6.9999
+.RS 0
+--extra-deps mysql,,,nginx,,
+.RE 1
+.TP
+.BI --native-deps " PACKAGES"
+Specify any native dependencies that should be added to the generated tpkg.
+Syntax is the same as --extra-deps.
+.TP
+.BI --install-options " INSTALLOPTS"
+Extra options to the
+.I gem install
+command that gem2tpkg will run.  Most commonly used to control where gem gets
+the gem from, via the --source option.  I.e.
+.PP
+.RS
+--install-options "--source http://gems.example.com"
+.RE
+.TP
+.BI --build-options " BUILDOPTS"
+Extra options to the gem build process.  If you were running
+.I gem install
+manually these would be options placed after a -- on the gem command line.
+I.e. these are not options to the gem command, but rather options to the build
+process of the gem being installed.  Most commonly used to help the gem build
+process find libraries.  I.e.
+.PP
+.RS
+--build-options "--with-sqlite3-dir=/opt/tpkg"
+.RE
+.TP
+.BI --gem-cmd " GEMCMD"
+The path to the gem command to be used.  The configuration of that instance of
+gem determines the paths that will be used in the generated package.
+.TP
+.BI --rubygems-path " PATH"
+Path to the rubygems library.  Useful if the copy of ruby being used to run
+gem2tpkg doesn't have rubygems in its library path.
+.TP
+.BI --extra-name " EXTRANAME"
+Extra string to add to package name.  Used to distinguish packages of the same
+gem built using different gem commands, and thus different directory
+structures.  If not specified
+.B gem2tpkg
+will attempt to do the right thing automatically based on whether or not it is
+using the default gem command.
+.TP
+.BR --help | \-h
+Display the
+.B gem2tpkg
+usage message and exit.
+
+.SH AUTHORS
+
+.B gem2tpkg
+is designed and maintained by Jason Heiss.
+

data/man/man1/tpkg.1

@@ -0,0 +1,411 @@
+.TH tpkg 1 "October 2009"
+
+.SH NAME
+
+.B tpkg
+\- Application package management and deployment
+
+.SH SYNOPSIS
+
+.B tpkg
+.RB [ --servers | \-s
+.IR SERVERS ]
+.RB [ --group | \-g
+.IR GROUP ]
+.RB [ --make | \-m
+.IR DIRECTORY ]
+.RB [ --extract | \-x
+.IR DIRECTORY ]
+.RB [ --download
+.IR PACKAGES ]
+.RB [ --install | \-i
+.IR PACKAGES ]
+.RB [ --upgrade | \-u
+.IR PACKAGES ]
+.RB [ --ua ]
+.RB [ --remove | \-r
+.IR PACKAGES ]
+.RB [ --rd
+.IR PACKAGES ]
+.RB [ --rp
+.IR PACKAGES ]
+.RB [ --ra ]
+.RB [ --verify | \-V ]
+.RB [ --start
+.IR NAME ]
+.RB [ --stop
+.IR NAME ]
+.RB [ --restart
+.IR NAME ]
+.RB [ --reload
+.IR NAME ]
+.RB [ --status
+.IR NAME ]
+.RB [ --start-all
+.IR NAME ]
+.RB [ --stop-all
+.IR NAME ]
+.RB [ --restart-all
+.IR NAME ]
+.RB [ --reload-all
+.IR NAME ]
+.RB [ --exec-init
+.IR NAME ]
+.RB [ --init-script
+.IR NAME ]
+.RB [ --init-cmd
+.IR NAME ]
+.RB [ --query | \-q
+.IR NAMES ]
+.RB [ --qs
+.IR NAME ]
+.RB [ --qa ]
+.RB [ --qas ]
+.RB [ --qi
+.IR NAME ]
+.RB [ --qis
+.IR NAME ]
+.RB [ --ql
+.IR NAME ]
+.RB [ --qls
+.IR NAME ]
+.RB [ --qf
+.IR FILE ]
+.RB [ --qr
+.IR NAME ]
+.RB [ --qd
+.IR NAME ]
+.RB [ --qds
+.IR NAME ]
+.RB [ --dw
+.IR INTEGER ]
+.RB [ --qX
+.IR NAME ]
+.RB [ --qXs
+.IR NAME ]
+.RB [ --history ]
+.RB [ --qenv ]
+.RB [ --qconf ]
+.RB [ --base
+.IR BASE ]
+.RB [ --source
+.IR SOURCE ]
+.RB [ --no-prompt | \-n ]
+.RB [ --quiet ]
+.RB [ --no-sudo ]
+.RB [ --lock-force ]
+.RB [ --force-replace ]
+.RB [ --force ]
+.RB [ --out | \-o
+.IR DIR ]
+.RB [ --skip-remove-stop ]
+.RB [ --use-ssh-key ]
+.RB [ --deploy-as
+.IR USERNAME ]
+.RB [ --debug ]
+.RB [ --version ]
+.RB [ --help | \-h ]
+
+.SH DESCRIPTION
+
+Tpkg is a tool for packaging and deploying applications. It is designed
+to work alongside your operating system's packaging tool. The deployment
+features in tpkg are designed to scale to deployments across hundreds or
+thousands of systems.
+
+.SH OPTIONS
+.TP
+.BI --servers|-s " SERVERS"
+Switches
+.B tpkg
+to deployment mode rather than local mode.  Specifies the server(s) to
+operate against in deployment mode.  Servers are specified as a
+comma-separated list. Alternatively, this option takes in a file name
+that contains the list of servers (newline as the delimiter)
+.B Tpkg
+will connect to each server via ssh and perform the requested operation.
+SSH and sudo password prompts will be handled.
+.TP
+.BI --group|-g " GROUP"
+Specifies a group of servers to operate against in deployment mode. Server
+names are obtained by running the host_group_script from tpkg.conf with the
+group names as arguments.
+.TP
+.BI --make|\-m " DIRECTORY"
+Make a package from the specified directory.  The directory must contain
+at a minimum a tpkg.xml file.
+.TP
+.BI --extract|\-x " DIRECTORY"
+Extract the metadata from a directory of packages to metadata.xml.  The
+client expects source directories to have this operation performed on
+them so that it can resolve dependencies without having to download all
+packages.
+.TP
+.BI --download " PACKAGES"
+Download the specified package(s).  Packages may be specified as name,
+name=version, name=version=packageversion, or as a filename or URL.
+.TP
+.BI --install|\-i " PACKAGES"
+Install the specified package(s).  Packages may be specified as name,
+name=version, name=version=packageversion, or as a filename or URL.  The
+equals signs may also be inequalities, for example ruby>=1.9
+.TP
+.BI --upgrade|\-u " PACKAGES"
+Upgrade the specified package(s).  Packages specified as with --install.
+If a specific version is not specified then the packages are upgraded to
+the latest available.
+.TP
+.B --ua
+Upgrade all packages to the latest available version.
+.TP
+.BI --remove|\-r " PACKAGES"
+Remove the specified packages.  Packages specified as with --install.
+.TP
+.BI --rd " PACKAGES"
+Similar to --remove|\-r but also remove all depending packages.
+.TP
+.BI --rp " PACKAGES"
+Similar to --remove|\-r but also remove all prerequisite packages.
+.TP
+.B --ra
+Remove all installed packages.
+.TP
+.BI --verify|\-V " NAME"
+Verify that the permissions, ownership and file contents of the files
+from the specified package have not been modified.
+.TP
+.BI --start " NAME"
+Run any init scripts associated with the specified package with a
+"start" argument.
+.TP
+.BI --stop " NAME"
+Run any init scripts associated with the specified package with a
+"stop" argument.
+.TP
+.BI --restart " NAME"
+Run any init scripts associated with the specified package with a
+"restart" argument.
+.TP
+.BI --reload " NAME"
+Run any init scripts associated with the specified package with a
+"reload" argument.
+.TP
+.BI --status " NAME"
+Run any init scripts associated with the specified package with a
+"status" argument.
+.TP
+.BI --start-all
+Run the init scripts of all installed packages with a "start" argument.
+.TP
+.BI --stop-all
+Run the init scripts of all installed packages with a "stop" argument.
+.TP
+.BI --restart-all
+Run the init scripts of all installed packages with a "restart" argument.
+.TP
+.BI --reload-all
+Run the init scripts of all installed packages with a "reload" argument.
+.TP
+.BI --exec-init
+Run the init scripts associated with the specified packages. Requires
+--init-cmd option to be specified.
+.TP
+.BI --init-script
+Use with the --exec-init option to specify what packages to run the init
+scripts.
+.TP
+.BI --init-cmd
+Use with the --exec-init option to specify what init action to run.
+.TP
+.BI --query|\-q " NAMES"
+Check if the specified packages are installed.
+.B Tpkg
+exit value will also indicate whether the package was found, so in
+combination with --quiet this can be useful in scripts.
+.TP
+.BI --qs " NAME"
+List packages on the server that match the specified name and are installable
+on the current machine.
+.TP
+.B --qa
+List all installed packages.
+.TP
+.B --qas
+List all packages on the server.
+.TP
+.BI --qi " NAME"
+Display info for the specified package.  Accepts the name of an installed
+package or the filename of an uninstalled package.
+.TP
+.BI --qis " NAME"
+Display info for the specified package on the server.
+.TP
+.BI --ql " NAME"
+List the files in the specified package.  Accepts the name of an installed
+package or the filename of an uninstalled package.
+.TP
+.BI --qls " NAME"
+List the files in the specified package on the server.
+.TP
+.BI --qf " FILE"
+List the package that owns the specified file.
+.TP
+.BI --qr " NAME"
+List installed packages that depend on the specified package.
+.TP
+.BI --qd " NAME"
+List the packages that the specified package depends on.  Accepts the name of
+an installed package or the filename of an uninstalled package.
+.TP
+.BI --qd " NAME"
+List the packages that the specified package on the server depends on.
+.TP
+.BI --dw " INTEGER"
+The number of workers to use when deploying.  Defaults to 10. Only meaningful
+when used with the servers option.
+.TP
+.BI --qX " NAME"
+Display the tpkg.xml for the specified package.  Accepts the name of an
+installed package or the filename of an uninstalled package.
+.TP
+.BI --qXs " NAME"
+Display the tpkg.xml for the specified package on the server.
+.TP
+.BI --history
+Display package installation history
+.TP
+.BI --qenv
+Display machine's information such as OS and architecture.
+.TP
+.BI --qconf
+Display tpkg's configuration settings.
+.TP
+.BI --base " BASE"
+Base directory for tpkg operations.  Command line option overrides the
+TPKG_HOME environment variable and config files.  The base directory must be a
+fully qualified path.
+.TP
+.BI --source " SOURCE"
+Specify additional sources where packages are located.
+.TP
+.BR --no-prompt | \-n
+Turn off confirmation prompts.
+.TP
+.B --quiet
+Reduce or eliminate informative but non-essential output.
+.TP
+.B --no-sudo
+Normally
+.B tpkg
+will re-execute itself with sudo for operations that might need root
+privileges.  This option disables that behavior.
+.TP
+.B --lock-force
+.B Tpkg
+locks the package database when performing install/upgrade/removal operations.
+If tpkg is interrupted for some reason it might leave the lock file behind.
+It will automatically remove lock files that are more than two hours old, this
+option can be used to force immediate removal.
+.TP
+.B --force-replace
+Replace the conflicting package(s) with the new one(s).
+.TP
+.B --force
+Force the execution of a given task.
+.TP
+.BR --out | \-o
+Output directory for the -m and --download option.
+.TP
+.B --skip-remove-stop
+tpkg normally runs any init scripts in the target packages with a "stop"
+argument on package removal. This option prevents that behavior. The init
+script might be known to be broken, etc.
+.TP
+.BI --use-ssh-key " [KEY]"
+Eliminate the prompt for an SSH password when deploying.  Specifying a
+specific key file is optional.
+.TP
+.BI --deploy-as " USERNAME"
+The user to use with SSH when deploying.  Defaults to the current user.
+.TP
+.BI --compress " [TYPE]"
+What compression to use when making packages. Defaults to gzip. bz2 is the
+other supported compression.  Setting the type to no will disable compression.
+.TP
+.B --debug
+Print lots of messages about what
+.B tpkg
+is doing.
+.TP
+.B --version
+Show the
+.B tpkg
+client version and exit.
+.TP
+.BR --help | \-h
+Display the
+.B tpkg
+usage message and exit.
+
+.SH FILES
+
+.TP
+.B /opt/tpkg
+The default
+.B tpkg
+base.  Relocatable packages are installed relative to the base directory.
+.B Tpkg
+stores its package database, cache, etc. in BASE/var/tpkg.
+.TP
+.B /etc/tpkg.conf, $HOME/.tpkg.conf
+Configuration file for
+.B tpkg.
+The home directory file overrides settings in the system-wide file.
+.RS 8
+.TP
+.BI "base = " BASE
+Set a different base other than /opt/tpkg.  The base directory must be a fully
+qualified path.
+.TP
+.BI "source = " SOURCE
+A URL or directory to use as a source of packages.  May be specified more than
+once if more than one source of packages is available.  The directory must
+have been prepared with the --extract option to create metadata.xml.
+.TP
+.BI "report_server = " URL
+The URL for a
+.B tpkg
+reporting server.  If this is defined then all package install/upgrade/removal
+operations will be reported to the server.
+.TP
+.BI "host_group_script = " FILENAME
+The filename for a script which takes one or more host group names as
+arguments and outputs the names of the hosts in those groups one per line on
+stdout.  Used with the --group option.
+.TP
+.BI "sudo = " true/false
+Should
+.B tpkg
+use sudo when performing package management operations?
+.RE
+.TP
+.B /etc/tpkg/ca.pem
+SSL certificate(s) needed to verify the
+.B tpkg
+server's identity. If
+.B tpkg
+is using a server with an https:// URL and if this file exists then
+.B tpkg
+will not proceed if the server's SSL certificate can't be verified against the
+certs in this file.
+
+.SH DIAGNOSTICS
+
+See the
+.B --debug
+option.
+
+.SH AUTHORS
+
+.B Tpkg
+is designed and maintained by Jason Heiss and Darren Dao.