diff options
authorIan Jackson <>2013-10-21 15:45:53 +0100
committerIan Jackson <>2013-10-21 15:45:53 +0100
commitb250e873041896930e9e1d2f92df580f5eb91529 (patch)
parentaa031dd019a9b1d561aafac0ddb04ad5b3ae25ee (diff)
docs for rpush
2 files changed, 24 insertions, 0 deletions
diff --git a/dgit b/dgit
index 2f4ce48..448412e 100755
--- a/dgit
+++ b/dgit
@@ -371,6 +371,7 @@ main usages:
dgit [dgit-opts] fetch|pull [dgit-opts] [suite]
dgit [dgit-opts] build [git-buildpackage-opts|dpkg-buildpackage-opts]
dgit [dgit-opts] push [dgit-opts] [suite]
+ dgit [dgit-opts] rpush build-host:build-dir ...
important dgit options:
-k<keyid> sign tag and package with <keyid> instead of default
--dry-run -n do not change anything, but go through the motions
diff --git a/dgit.1 b/dgit.1
index 02d54a3..3086caf 100644
--- a/dgit.1
+++ b/dgit.1
@@ -20,6 +20,10 @@ dgit \- git integration with the Debian archive
.B dgit
+[\fIdgit\-opts\fP] \fBrpush\fR \fIbuild-host\fR\fB:\fR\fIbuild-dir\fR
+[\fIpush args...\fR]
+.B dgit
[\fIdgit\-opts\fP] \fIaction\fR ...
.B dgit
@@ -145,6 +149,25 @@ specifies a suite then that must match too.
If dgit push fails while uploading, it is fine to simply retry the
dput on the .changes file at your leisure.
+\fBdgit rpush\fR \fIbuild-host\fR\fB:\fR\fIbuild-dir\fR [\fIpush args...\fR]
+Pushes the contents of the specified directory on a remote machine.
+This is like running dgit push on build-host with build-dir as the
+current directory; however, signing operations are done on the
+invoking host. This allows you to do a push when the system which has
+the source code and the build outputs has no access to the key.
+However, the build-host must be able to ssh to the dgit repos. If
+this is not already the case, you must organise it separately, for
+example by the use of ssh agent forwarding.
+The remaining arguments are treated just as dgit push would handle
+build-host and build\-dir can be passed as separate
+arguments; this is assumed to be the case if the first argument
+contains no : (except perhaps on in [ ], to support IPv6 address
.B dgit quilt-fixup
Looks to see if the tree is one which dpkg-source cannot properly
represent. If it isn't, dgit will fix it up for you (in quilt terms,