[Et-mgmt-commits-list] [SCM] surfr branch, master now at 5f9cf9cc878acd1c796de9e586a09801658b087e
MáirÃn Duffy (none)
duffy at redhat.com
Tue May 22 22:15:33 UTC 2007
Hello,
This is an automated email from the git hooks/update script, it was
generated because a ref change was pushed to the repository.
Updating branch, master,
via 5f9cf9cc878acd1c796de9e586a09801658b087e (commit)
from aded1d4091af3a9ef420467087bdc2ad913df0be (commit)
- Log -----------------------------------------------------------------
commit 5f9cf9cc878acd1c796de9e586a09801658b087e
Author: MáirÃn Duffy <duffy at spira.(none)>
Date: Tue May 22 18:14:30 2007 -0400
updating from yesterday's meeting notes, fixing line wraps
-----------------------------------------------------------------------
Diffstat:
surfr-manpage.txt | 138 +++++++++++++++++++++++++++++++++++------------------
1 files changed, 92 insertions(+), 46 deletions(-)
diff --git a/surfr-manpage.txt b/surfr-manpage.txt
index ae1d0c4..41d59de 100644
--- a/surfr-manpage.txt
+++ b/surfr-manpage.txt
@@ -24,62 +24,71 @@ DESCRIPTION
Unless the --help or -h option is given, one of the above commands must be present.
add
- Used to add content to an existing software channel. If provided, this command will only
- add content listed in the provided package manifest (resolving dependencies from outside the
- manifest as required.)
+ Used to add content to an existing software channel. If
+provided, this command will only add content listed in the provided package
+manifest (resolving dependencies from outside the manifest as required.) Added
+content is mirrored by default. (You may use the --no-mirror option if this is
+not preferred)
create
- Is used to create a new emtpy software channel, name specified by channel-name.
+ Is used to create a new emtpy software channel, name specified
+by channel-name.
delete
Is used to delete an existing channel.
describe
- Prints out basic metadata on a channel - its name, owner, date created, date last updated,
- constituent repos, etc.
+ Prints out basic metadata on a channel - its name, owner, date
+created, date last updated, constituent repos, etc.
diff
- Used to create a diff between the indicated software channel and its source or another channel.
- Where content exists in one location and not in the other, this content's name and location will
- be indicated in the diff file. Where content exists in both locations but are at different verions,
- the version of the content at each location will be indicated in the diff file. Output is a
- plaintext file with one content difference listed per line.
+ Used to create a diff between the indicated software channel
+and its source or another channel. Where content exists in one location and
+not in the other, this content's name and location will be indicated in the
+diff file. Where content exists in both locations but are at different
+verions, the version of the content at each location will be indicated in the
+diff file. Output is a plaintext file with one content difference listed per
+line.
list-channels
- Lists all channel names on the server line-by-line in alphabetical order. Per channel, lists
- constituent repos and owners, as well as upstream source per constituent mirror repo.
+ Lists all channel names on the server line-by-line in
+alphabetical order. Per channel, lists constituent repos and owners, as well
+as upstream source per constituent mirror repo.
list-packages
- Lists all package names in provided channels, one per line. Includes version, architecture,
- and source per package.
+ Lists all package names in provided channels, one per line.
+Includes version, architecture, and source per package.
mirror
- Is used to create a copy of a currently-existing sourcechannel(s) and/or repourl(s) that may
- be synchronized with the content sources. The mirror's name is determined by channel-name.
- If provided, this command will only mirror content listed in the provided package
- manifest (resolving dependencies from outside the manifest as required.)
+ Is used to create a copy of a currently-existing
+sourcechannel(s) and/or repourl(s) that may be synchronized with the content
+sources. The mirror's name is determined by channel-name. If provided, this
+command will only mirror content listed in the provided package manifest
+(resolving dependencies from outside the manifest as required.) Mirrored
+content is kept in sync automatically.
remove
- Used to remove content from an existing software channel. If provided, this command will only
- remove content listed in the provided package manifest (resolving dependencies from outside the
- manifest as required.) May only be applied to static repositories (repos that are not mirrored)
+ Used to remove non-mirrored content from an existing software channel. If provided, this command will only remove content listed in the provided package
+manifest (resolving dependencies from outside the manifest as required.)
search
- Search indicated channels (all if none provided) for the specified content. Will return a list
- of all channels the content is located in indicating the full package name in each.
+ Search indicated channels (none if none provided, use --all
+option to search through all channels) for the specified content. Will return a list of all channels the content is located in indicating the full package name in each.
snapshot
- Is used to create a one-time snapshot of a currently-existing sourcechannel(s) and/or repourl(s).
- This snapshot will be a yum repository with name channel-name, with administraton privileges
- granted to admin. The repository will be located in $DIR specified by $CONF_FILE. If provided,
- this command will only clone content listed in the provided package manifest (resolving
- dependencies from outside the manifest as required.)
+ Is used to create a one-time snapshot of a currently-existing
+sourcechannel(s) and/or repourl(s). This snapshot will be a yum repository
+with name channel-name, with administraton privileges granted to admin. The
+repository will be located in $DIR specified by $CONF_FILE. If provided, this
+command will only copy content listed in the provided package manifest
+(resolving dependencies from outside the manifest as required.)
update
- Is used to synchronize the content in a channel with its source(s). If provided,
- this command will only synchronize content with the provided source locations. If provided,
- this command will only synchronize content with the provided package manifest (resolving
- dependencies from outside the manifest as required.)
+ Is used to synchronize any mirrored content in a channel with its
+source(s). If provided, this command will only synchronize content with the
+provided source locations. If provided, this command will only synchronize
+content with the provided package manifest (resolving dependencies from
+outside the manifest as required.)
GENERAL OPTIONS
@@ -87,31 +96,47 @@ GENERAL OPTIONS
Help; display a help message and then quit.
-c [config file]
- Specifies the config file location - can take http, ftp urls and local file paths.
+ Specifies the config file location - can take http, ftp urls
+and local file paths.
--version
reports the surfr version number and exits.
+ --all
+ Used with the search command to indicate the search term
+should be searched for across all available channels.
+
--owner=owner-identifier
- Specifies channel owner. For now, can be used to store email address of channel owner.
+ Specifies channel owner. For now, can be used to store email
+address of channel owner.
--content-source=path-to-content-source
- Specifies yum repository or existing software channel name to be used as a content source.
- Supports http://, https://, ftp:// protocols for yum repositories.
+ Specifies yum repository or existing software channel name to
+be used as a content source. Supports http://, https://, ftp:// protocols for
+yum repositories.
+
+ --content-manifest=<ContentManifest>
+ Specifies location of comma-delimited file with list of
+content names (e.g., RPM package names). Used to filter content provided in
+create, clone, mirror, and update operations. A '-' before content name
+filters it out of inclusion, package name alone marks content for inclusion.
- --content-manifest=path-to-contentmanifest-file
- Specifies location of comma-delimited file with list of content names (e.g., RPM package names).
- Used to filter content provided in create, clone, mirror, and update operations. A '-' before
- content name filters it out of inclusion, package name alone marks content for inclusion.
+ --errata=<ErrataNumber1,ErrataNumber2>
+ Used with the update command, indicates specific errata to
+update a channel with.
--groups=path-to-comps.xml-file
- Specifies location of comps.xml file for creating package groups within channel. Used in create,
- clone, and mirror operations.
+ Specifies location of comps.xml file for creating package
+groups within channel. Used in create, clone, and mirror operations.
+
+ --no-mirror
+ Used with the add command, indicates that content being added
+to the channel will not be mirrored.
MISC
Specifying package names
- A package can be referred to for install,update,list,remove etc with
- any of the following:
+ A package can be referred to for install,update,list,remove etc
+with any of the following:
name
name.arch
@@ -121,7 +146,28 @@ MISC
name-epoch:ver-rel.arch
epoch:name-ver-rel.arch
- For example: surfr create my-channel --content-manifest=kernel-2.4.1-10.i686
+ For example: surfr create my-channel
+--content-manifest=kernel-2.4.1-10.i686
+
+ Content manifests
+ Content manifests should specify one piece of content per
+line. A URL or filename may be used to refer to each piece of content.
+
+USAGE EXAMPLES
+
+surfr create foo-channel /magic/path/to/content
+
+surfr create bar-channel http://mirror.example.com/path/to/yum/repo
+
+surfr add bar-channel ftp://mirror.example.com/path/to/yum/repo
+
+surfr create baz-channel rsync://...
+
+surfr remove baz-channel evolution minesweeper3000
+
+surfr clone baz-channel baz2-channel
+
+surfr update baz-channel
FILES
/etc/surfr.conf
hooks/update
---
Git Source Code Management System
hooks/update refs/heads/master \
aded1d4091af3a9ef420467087bdc2ad913df0be \
5f9cf9cc878acd1c796de9e586a09801658b087e
More information about the Et-mgmt-commits-list
mailing list