76b43e4417bab52e913da39b5f5bc2a130d3f149Timo Sirainenpkg
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenDEPOT
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen1. Summary
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen This document describes the architecture of a pkg(5) depot server as
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen implemented in pkg.depotd(1m). This includes: an overview of the depot
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen server's filesystem layout, operations provided by the depot server,
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen the interfaces provided by the depot server, and a description of how
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen clients communicate with the depot server for each operation.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen NOTE: The image packaging system is under development. Changes to
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen interfaces may occur as part of the architectural review process, as
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen shortcomings are identified, and as new features are introduced.
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen Questions about planned or possible change should be asked on
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen pkg-discuss.
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen2. Discussion
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen A pkg(5) depot server provides a way for clients to interact with package
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen content and metadata contained within a pkg(5) repository, and with the
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen depot server itself. It accomplishes this by providing an HTTP-based
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen interface suitable for usage by pkg(1) clients and web user agents.
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen2.1. Filesystem Layout
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen The types of information that the depot server stores and/or retrieves can
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen be categorized as follows:
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen - depot data
f16c114c20bbd7d292d93415d1e56c8dd6abd3e7Timo Sirainen This includes: configuration data, presentation content (such as
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen web page templates), publishing data (e.g. in-flight transactions),
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen and temporary data (e.g. the feed cache).
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
8fcff4c5b52f24d9c681805fdf06b486f1d0fcbeTimo Sirainen - repository data
16f816d3f3c32ae3351834253f52ddd0212bcbf3Timo Sirainen This includes: catalog information, package content (files), package
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen metadata (manifests), and search data.
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen2.1.1. Layout
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen The depot server uses the following 'root' directory structures for the
84e1634acc701d14e358e27f1beff5ad74f5004aTimo Sirainen storage and retrieval of depot and repository data:
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen - repo_dir (depot and repository data)
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen cfg_cache (depot data)
8fcff4c5b52f24d9c681805fdf06b486f1d0fcbeTimo Sirainen A file containing the cached configuration information for the
022412398e56a8f31ef111cfd7271498d64af9a9Timo Sirainen depot server.
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen
8fcff4c5b52f24d9c681805fdf06b486f1d0fcbeTimo Sirainen catalog/ (repository data)
9aa52288a4b53186d81b0ec9afa7d9e0a8ee8753Timo Sirainen This directory contains the repository catalog and its related
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen metadata.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen
e06c0b65c16ccce69bbee009ead14d7d3d17a256Timo Sirainen file/ (repository data)
7a6b45405fb1544ac476e6eb1402a70cc1ddcdcfTimo Sirainen This directory contains the file content of packages in the
e05ea8311ae16687295048e88ca205dfe29fbcbfTimo Sirainen repository.
8fcff4c5b52f24d9c681805fdf06b486f1d0fcbeTimo Sirainen
8fcff4c5b52f24d9c681805fdf06b486f1d0fcbeTimo Sirainen Files are stored using a two-level path fragment, derived from the
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen SHA1-hash of a file's content, assumed to have at least 8 distinct
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen characters.
f7d43647acc6dc80064c8c4cacf5bf86f754c530Timo Sirainen
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen Example:
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen 00/
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen 0023bb/
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen 000023bb53fdc7bcf35e62b7b0b353a56d36a504
98c1cf256927e254f0c092acd2ddcd7ea50bd009Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen index/ (repository data)
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen This directory contains the search indices for the repository.
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen pkg/ (repository data)
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen This directory contains the metadata (manifests) for the
b6d817f0effeff645aadc01fd468a7d4084ba1f2Timo Sirainen repository's packages.
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen The manifests for each package are stored in a directory with the
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen same name as the package stem using a URL-encoded filename.
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen Example:
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen entire/
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen 0.5.11%2C5.11-0.86%3A20080422T234219Z
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen trans/ (depot data)
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen This directory contains in-flight transactions for packages that
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen are waiting for the publication process to complete so that they
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen can be added to the repository's catalog.
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen Each transaction is stored in a directory named after the pending
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen transaction id and contains the manifest waiting for publication
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen to finish stored with the filename of 'manifest'.
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen Example:
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen 1229379580_pkg%3A%2Fsystem%2Flibc%400.1%2C5.11-98%3A20081215T221940Z/
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen manifest
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen updatelog/ (repository data)
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen This directory contains metadata detailing changes to the repository
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen by publishing operations.
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen - content_root (depot data)
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen web/
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen This directory contains all of the web presentation content for the
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen depot.
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen2.2. Operations
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen When communicating with the depot server via HTTP, operations are presented
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen via a URL-based mechanism that allows each to be versioned so that changes
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen in protocol can be hidden from older clients as the interfaces to operations
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen evolve.
6288d3611eda14a017dae9927b73f46afb646c96Timo Sirainen
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen Operations made available by a pkg.depotd(5) server can be accessed via GET
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen or POST, as appropriate for each operation, via a URL such as the following:
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen http://pkg.opensolaris.org/release/manifest/0/SUNWvim%407.1.284%2C5.11-0.101%3A20081119T230659Z
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen The above example can be broken down into four basic components:
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen publisher_origin_url - http://pkg.opensolaris.org/release/
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen operation_name - manifest
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen protocol_version - 0
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen operation_arguments - SUNWvim%407.1.284%2C5.11-0.101%3A20081119T230659Z
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen Each of these components can be described as follows:
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen publisher_origin_url - A URL that can be used to access a depot
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen server's repository.
299183fbb6ec5d0828a0880da372540421ac4665Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen operation_name - The name of the operation that the client is
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen wanting to initiate.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen protocol_version - An integer value representing the version of
9e59a1f3f095b3099478562cf3f3970a24736970Timo Sirainen the operation's protocol spoken by the client.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
178511b57faa7c3f8203dd8b7e4059d00cbfc23aTimo Sirainen operation_arguments - String data (such as a package FMRI) that is
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen parsed and then used to determine what
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen resource(s) will be used to perform an
2e937ed8585299b2e879a28314902a5f644813d2Timo Sirainen operation. Some operations expect arguments
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen or data to be passed via POST-based form data,
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen headers, or the request body instead.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen2.2.1. Operation Types
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen Each operation that the depot server provides is either designed to interact
e68309fcfa2eaa88217fd51e7b4900fc9c20ef5dTimo Sirainen with a pkg(5) repository, or with the depot server itself. These operations
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen can be categorized as follows:
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen - content
e5c08648676d1989f6e70b95e5990c26b3e8b96bTimo Sirainen These operations are read-only, and retrieve file data that comprises
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen the content of a package in a repository.
c3412ddeb9abc13f99d3caf50faf76cd99f7e9d2Timo Sirainen
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen - depot
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen These operations are read-only, and permit retrieval of: the list of
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen operations that the depot server currently provides (including protocol
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen version and pkg(5) software version), statistics information, and other
02b79f9c2636da1829eee5b92753602bba8b67edTimo Sirainen depot information.
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen
1e76a5b92f9d82d557f81f080f3dfad1c9d8f200Timo Sirainen - metadata
1e76a5b92f9d82d557f81f080f3dfad1c9d8f200Timo Sirainen These operations are read-only, and retrieve metadata related to a
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen package FMRI, such as its name, version, etc. stored in a repository's
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen catalog.
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen - publishing
e8a35266a5ceacdfafeeffd6bddae77931ff97ebTimo Sirainen These operations alter a repository's catalog, package metadata, and
9aa52288a4b53186d81b0ec9afa7d9e0a8ee8753Timo Sirainen allow storage of package content.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen2.2.2. Modes
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
b08b33d1f5ce3721dc2d83586c9cb0ca141331fdTimo Sirainen Which types of operations are available is dependent on which mode the depot
b08b33d1f5ce3721dc2d83586c9cb0ca141331fdTimo Sirainen server is currently operating in:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen - default
6843896c40bee4f9b6680ca7ced598c446e9f999Timo Sirainen In default mode, the depot server allows content, depot, metadata,
6843896c40bee4f9b6680ca7ced598c446e9f999Timo Sirainen and publishing operations.
6843896c40bee4f9b6680ca7ced598c446e9f999Timo Sirainen
6843896c40bee4f9b6680ca7ced598c446e9f999Timo Sirainen - readonly
b08b33d1f5ce3721dc2d83586c9cb0ca141331fdTimo Sirainen In readonly mode, the depot server allows content, depot, and
022412398e56a8f31ef111cfd7271498d64af9a9Timo Sirainen metadata operations.
022412398e56a8f31ef111cfd7271498d64af9a9Timo Sirainen
022412398e56a8f31ef111cfd7271498d64af9a9Timo Sirainen - mirror
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen In mirror mode, the depot server allows content and depot
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen operations.
313fe89df4d91cd0cd7f3558dc6d7fd21ad39eeeTimo Sirainen
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen2.2.3. Content Operations
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen The pkg.depotd(5) server provides the following operations for retrieving
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen package content:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen - file
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Version 0:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen A GET operation that retrieves the contents of a file, belonging to a
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen package, using a SHA-1 hash of the file's content.
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Example:
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen URL:
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen http://pkg.opensolaris.org/release/file/0/
df4018ae2f0a95be602f724ca70df7e0e3bd6a7dTimo Sirainen a00030db8b91f85d0b7144d0d4ef241a3f1ae28f
df4018ae2f0a95be602f724ca70df7e0e3bd6a7dTimo Sirainen
a393d9d6dabdc46cf724f8cb004a652b4036d53dTimo Sirainen Expects:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen A SHA-1 hash of the file's content belonging to a package in the
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen request path.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Returns:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen The contents of the file, compressed using the gzip compression
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen algorithm.
a393d9d6dabdc46cf724f8cb004a652b4036d53dTimo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen2.2.2. Depot Operations
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen - versions
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen Version 0:
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen A GET operation that retrieves text data representing what operations
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen are supported and version information about the depot server.
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen Example:
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen URL:
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen http://pkg.opensolaris.org/versions/0/
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen Expects:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Nothing
a2637488c8d514ec1ac3914811deee814f9761b3Timo Sirainen
7f773564b94e6054a40d3785cb63c29f1e4d4deeTimo Sirainen Returns:
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen text/plain data containing the version of the pkg(5) software that
2bf7bb14894faf721518e2122a14a2389ef94078Timo Sirainen the depot is based upon, a list of the operations currently
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen supported, and the protocol version supported for each
9a06cabdfdf4d5e2f19a07e506c3c7d08a7e7038Timo Sirainen operation.
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Sample Output:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen pkg-server bfc04991436e
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen info 0
6843896c40bee4f9b6680ca7ced598c446e9f999Timo Sirainen search 0
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen versions 0
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen catalog 0
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen manifest 0
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen add 0
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen file 0
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen abandon 0
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen close 0
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen open 0
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen2.2.2. Meta-data Operations
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen - catalog
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Version 0:
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen A GET operation that retrieves a text/plain datastream
f6699a08521aacc4c2bb5b6175691dad5f715f8cTimo Sirainen representing a complete catalog or an incremental update to an
df4018ae2f0a95be602f724ca70df7e0e3bd6a7dTimo Sirainen existing one as requested.
df4018ae2f0a95be602f724ca70df7e0e3bd6a7dTimo Sirainen
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen Example:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen URL:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen http://pkg.opensolaris.org/catalog/0/
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Expects:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Nothing or the following headers:
f0f9c8e94abac18f8acd91b9e724c4c32863723aTimo Sirainen If-Modified-Since: {ISO 8601 formatted date and time in UTC}
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen Returns:
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen Either the contents of a pkg(5) catalog file, or the entries
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen that were added since the specified date as they are found
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen in the catalog file, separated by newlines.
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen - info
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen Version 0:
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen A GET operation that retrieves a text/plain description of a
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen package and its licensing information specified by the provided
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen FMRI.
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Example:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen URL:
6ef7e31619edfaa17ed044b45861d106a86191efTimo Sirainen http://pkg.opensolaris.org/info/0/entire@0.5.11,5.11-0.101:20081119T235706Z
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen Expects:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen A URL-encoded pkg(5) FMRI, excluding the 'pkg:/' scheme prefix
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen and publisher information, and including the full version
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen information.
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Returns:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen A text/plain representation of the specified package and its
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen licensing information.
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen
4d25408732be27e91f0430f71e87242760c2517cTimo Sirainen Sample Output:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Name: entire
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Summary: entire incorporation
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Publisher: Unknown
8af07808ba203f8709e2ff9eaf2291e1c4a4d53dTimo Sirainen Version: 0.5.11
7797aa2479e99aeb71057b7a2584b2cb72e4d3f8Timo Sirainen Build Release: 5.11
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen Branch: 0.101
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Packaging Date: Wed Nov 19 23:57:06 2008
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Size: 0.00 B
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen FMRI: pkg:/entire@0.5.11,5.11-0.101:20081119T235706Z
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen License:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen - manifest
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen Version 0:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen A GET operation that retrieves the contents of the manifest file for
61f5256ef248d35459b53534ae428bf6d016e1c5Timo Sirainen a package specified by the provided FMRI.
61f5256ef248d35459b53534ae428bf6d016e1c5Timo Sirainen
61f5256ef248d35459b53534ae428bf6d016e1c5Timo Sirainen Example:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen URL:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen http://pkg.opensolaris.org/manifest/0/entire@0.5.11,5.11-0.101:20081119T235706Z
d5cebe7f98e63d4e2822863ef2faa4971e8b3a5dTimo Sirainen
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen Expects:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen A URL-encoded pkg(5) FMRI excluding the 'pkg:/' scheme prefix
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen and publisher information and including the full version
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen information.
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen Returns:
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen The contents of the package's manifest file.
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen - p5i
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen Version 0:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen A GET operation that retrieves an application/vnd.pkg5.info
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen datastream representing publisher and package information.
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen This is intended for consumption by clients for the purposes
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen of auto-configuration, metadata management policy determination,
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen and triggering packaging operations such as installation.
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen Example:
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen URL:
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen http://pkg.opensolaris.org/release/p5i/0/SUNWcs
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Expects:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A full or partial URL-encoded pkg(5) FMRI, excluding the
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen publisher prefix. If the partial or full FMRI is valid, it will
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen be added to the datastream as is. If it includes the wildcard
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen character '*', a search of the repository's catalog for matching
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen entries will be performed and the unique set of resulting
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen package stems will be added to the datastream. If no match is
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen found, a 404 error will be raised.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Returns:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Returns a pkg(5) information datastream based on the repository
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen configuration's publisher information and the provided full or
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen partial FMRI or matching entries. The Content-Type of the
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen response is 'application/vnd.pkg5.info'.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen - publisher
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Version 0:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A GET operation that retrieves an application/vnd.pkg5.info
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen datastream representing publisher information. This is intended
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen for consumption by clients for auto-configuration and metadata
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen management policy determination.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Example:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen URL:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen http://pkg.opensolaris.org/release/publisher/0
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Expects:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Nothing
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Returns:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Returns a pkg(5) information datastream based on the repository
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen configuration's publisher information. The Content-Type of the
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen response is 'application/vnd.pkg5.info'.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen - search
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Version 0:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A GET operation that retrieves a text/plain list of packages with
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen metadata that matches the specified criteria.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Example:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen URL:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen http://pkg.opensolaris.org/release/search/0/vim
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Expects:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A URL-encoded token representing the search criteria.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Returns:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A text/plain list of matching entries, separated by newlines.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Each entry consists of a set of four space-separated values:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen index - what search index the entry was found in
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen action - what package action the entry is related to
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen value - the value that the matched the search criteria
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen package - the fmri of the package that contains the match
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Results are streamed to the client as they are found.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Sample Output:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen basename pkg:/SUNWvim@7.1.284,5.11-0.101:20081119T230659Z dir usr/share/vim
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen basename pkg:/SUNWvim@7.1.284,5.11-0.93:20080708T171331Z file usr/bin/vim
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen2.2.3. Publishing Operations
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen - add
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Version 0:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A POST operation that adds content to an in-flight transaction for
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen the Transaction ID specified. This could either be file content
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen for the package or metadata about the package.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen This data is not added to the repository for retrieval until a close
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen operation for the specified Transaction ID is executed.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Example:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen URL:
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen http://pkg.opensolaris.org/add/0/1228870796_pkg%3A%2Fsystem%2Flibc%400.1%2C5.11-98%3A20081210T005956Z
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen HEADERS:
5137d2d80255938a0f5fb8f3c1a21b34cf11ada3Timo Sirainen X-IPkg-SetAttr1: description=Package Name
33d63688ed8b26dc333e3c2edbfb2fe6e412604dTimo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen REQUEST BODY:
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Expects:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A Transaction ID as output by pkgsend(1) in the request path.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen The file content (if applicable), to be added, in the request
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen body. Any attributes to be set in the headers in the pattern
d0d7fcf3ce44f26fdf34c1542a25cec644c5c4c7Timo Sirainen of:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen X-IPkg-SetAttr{integer}: attr=value
d0d7fcf3ce44f26fdf34c1542a25cec644c5c4c7Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Returns:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Response status of 200 on success; any other status indicates
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen failure.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
16c89b1260c9d07c01c83a9219424d3727069b2eTimo Sirainen - abandon
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen Version 0:
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen A GET operation that aborts an in-flight transaction for the
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen Transaction ID specified. This will discard any data related to
7797aa2479e99aeb71057b7a2584b2cb72e4d3f8Timo Sirainen the transaction.
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen
b5e6f6f27c1461f0f9f202615eeb738a645188c3Timo Sirainen Example:
7f3be7d885c75cdd77f536929a45bc9764595960Timo Sirainen URL:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen http://pkg.opensolaris.org/abandon/0/1228870796_pkg%3A%2Fsystem%2Flibc%400.1%2C5.11-98%3A20081210T005956Z
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Expects:
3f26c5aced2e71efc783f26bb8a7ac53f7504622Timo Sirainen A Transaction ID as output by pkgsend(1) in the request path.
3f26c5aced2e71efc783f26bb8a7ac53f7504622Timo Sirainen
3f26c5aced2e71efc783f26bb8a7ac53f7504622Timo Sirainen Returns:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Response status of 200 on success; any other status indicates
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen failure.
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen - close
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Version 0:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A GET operation that ends an in-flight transaction for the
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Transaction ID specified. If successful, the corresponding package
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen is added to the repository catalog and is immediately available to
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen repository users.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
16c89b1260c9d07c01c83a9219424d3727069b2eTimo Sirainen Example:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen URL:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen http://pkg.opensolaris.org/abandon/0/1228870796_pkg%3A%2Fsystem%2Flibc%400.1%2C5.11-98%3A20081210T005956Z
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen Expects:
1cd97699af9c77d8f5920832ec3374884544fd68Timo Sirainen A Transaction ID as output by pkgsend(1) in the request path.
bb10ebcf076c959c752f583746d83805d7686df8Timo Sirainen
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen Returns:
a0b0d629931773c17a236f6214adbe0e13b9b3fdTimo Sirainen Response status of 200 on success; any other status indicates
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen failure.
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen - open
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Version 0:
c84985f66c5c83db642d136aefa8864cb45158cfTimo Sirainen A GET operation that starts an in-flight transaction for the
c84985f66c5c83db642d136aefa8864cb45158cfTimo Sirainen package FMRI specified.
c84985f66c5c83db642d136aefa8864cb45158cfTimo Sirainen
c84985f66c5c83db642d136aefa8864cb45158cfTimo Sirainen Example:
1d3f7c1278168d5b1cbfa9a2cc9929a0909056b4Timo Sirainen URL:
a8b8cce8569753ed47c94782283a24fb11c5ab52Timo Sirainen http://pkg.opensolaris.org/open/0/system%2Flibc@0.1-98
a8b8cce8569753ed47c94782283a24fb11c5ab52Timo Sirainen
e8a35266a5ceacdfafeeffd6bddae77931ff97ebTimo Sirainen Expects:
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen A URL-encoded pkg(5) FMRI (excluding timestamp).
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen Returns:
6ef7e31619edfaa17ed044b45861d106a86191efTimo Sirainen Response status of 200 on success and an identifier for the new
73b50eecfc31750a312e2f940023f522eb07178cTimo Sirainen transaction in the 'Transaction-ID' response header; any other
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen status indicates failure.
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen
dda2c506c8fc8ac2f88272de4523ded42baa0aa0Timo Sirainen3. References
e68309fcfa2eaa88217fd51e7b4900fc9c20ef5dTimo Sirainen
e68309fcfa2eaa88217fd51e7b4900fc9c20ef5dTimo Sirainen