msyds/gf-core
1
0
Fork 0
forked from GitHub/gf-core
Code Pull Requests Activity

Include darcs-cm script.

Browse Source
This commit is contained in:
bringert
2005-11-24 12:59:28 +00:00
parent d1cb1b5be4
commit 221b3412fa
2 changed files with 110 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

101
doc/darcs.html
View File

@@ -27,24 +27,27 @@ GF has now been moved to a Darcs repository. No changes should be committed to t
<LI><A HREF="#toc9">Setting up your $PATH on the Chalmers system</A> <LI><A HREF="#toc9">Setting up your $PATH on the Chalmers system</A>
<LI><A HREF="#toc10">Setting up ssh alias and ControlMaster</A> <LI><A HREF="#toc10">Setting up ssh alias and ControlMaster</A>
<LI><A HREF="#toc11">Setting up an ssh ControlMaster connection</A> <LI><A HREF="#toc11">Setting up an ssh ControlMaster connection</A>
<LI><A HREF="#toc12">Getting a fresh copy</A>
<LI><A HREF="#toc13">Getting other people's changes?</A>
<LI><A HREF="#toc14">Commit your changes</A>
<LI><A HREF="#toc15">Apply a patch from someone else</A>
</UL>
<LI><A HREF="#toc16">Troubleshooting</A>
<UL> <UL>
<LI><A HREF="#toc17">I get the error "darcs not found" when pushing</A> <LI><A HREF="#toc12">Automating the ControlMaster connection</A>
<LI><A HREF="#toc18">I get the error "(sftp) failed to fetch files."</A> </UL>
<LI><A HREF="#toc19">I get the error "Not a repository: gfreposerver:..."</A> <LI><A HREF="#toc13">Getting a fresh copy</A>
<LI><A HREF="#toc20">How do I avoid typing in my password so many times?</A> <LI><A HREF="#toc14">Getting other people's changes?</A>
<LI><A HREF="#toc15">Commit your changes</A>
<LI><A HREF="#toc16">Apply a patch from someone else</A>
</UL>
<LI><A HREF="#toc17">Troubleshooting</A>
<UL> <UL>
<LI><A HREF="#toc21">Using ssh ControlMaster</A> <LI><A HREF="#toc18">I get the error "darcs not found" when pushing</A>
<LI><A HREF="#toc22">Using ssh-agent</A> <LI><A HREF="#toc19">I get the error "(sftp) failed to fetch files."</A>
<LI><A HREF="#toc20">I get the error "Not a repository: gfreposerver:..."</A>
<LI><A HREF="#toc21">How do I avoid typing in my password so many times?</A>
<UL>
<LI><A HREF="#toc22">Using ssh ControlMaster</A>
<LI><A HREF="#toc23">Using ssh-agent</A>
</UL> </UL>
</UL> </UL>
<LI><A HREF="#toc23">Technical Information</A> <LI><A HREF="#toc24">Technical Information</A>
<LI><A HREF="#toc24">Further information about Darcs</A> <LI><A HREF="#toc25">Further information about Darcs</A>
</UL> </UL>
<P></P> <P></P>
@@ -228,6 +231,45 @@ somewhere.
You may want to create a script or alias for starting the connection. You may want to create a script or alias for starting the connection.
</P> </P>
<A NAME="toc12"></A> <A NAME="toc12"></A>
<H3>Automating the ControlMaster connection</H3>
<P>
You can create a darcs wrapper which sets up a ControlMaster connection
if there isn't one already. Put the code below in for example <CODE>~bin/darcs-cm</CODE>,
and use that program instead of <CODE>darcs</CODE> to work with the repository.
</P>
<PRE>
#!/bin/bash
DARCS=`which darcs`
SSH=`which ssh`
REPOSERVER=gfreposerver
if [ ! -x "$SSH" ]; then
echo "ssh ($SSH): command not found" 1&gt;&amp;2
exit 1
fi
if [ "$1" = "--stop" ]; then
$SSH -O exit "$REPOSERVER"
exit $?
fi
if [ ! -x "$DARCS" ]; then
echo "darcs ($DARCS): command not found" 1&gt;&amp;2
exit 1
fi
if ! $SSH -O check "$REPOSERVER" &gt;&amp; /dev/null; then
echo "Connection to $REPOSERVER is down, connecting..."
$SSH -f -M "$REPOSERVER" \
"bash -c 'while true; do echo -n .; sleep 30; done'" &gt; /dev/null
sleep 1
fi
exec $DARCS "$@"
</PRE>
<P></P>
<A NAME="toc13"></A>
<H2>Getting a fresh copy</H2> <H2>Getting a fresh copy</H2>
<P> <P>
Get your copy with (all on one line): Get your copy with (all on one line):
@@ -242,7 +284,7 @@ history for the repository. This saves space, bandwidth and CPU time,
and most people don't need the full history of all changes in the and most people don't need the full history of all changes in the
past. past.
</P> </P>
<A NAME="toc13"></A> <A NAME="toc14"></A>
<H2>Getting other people's changes?</H2> <H2>Getting other people's changes?</H2>
<P> <P>
Get all new patches from the main repo: Get all new patches from the main repo:
@@ -254,7 +296,7 @@ Get all new patches from the main repo:
<P> <P>
Without <CODE>-a</CODE>, you can choose which patches you want to get. Without <CODE>-a</CODE>, you can choose which patches you want to get.
</P> </P>
<A NAME="toc14"></A> <A NAME="toc15"></A>
<H2>Commit your changes</H2> <H2>Commit your changes</H2>
<P> <P>
There are two steps to commiting a change to the main repo. First you There are two steps to commiting a change to the main repo. First you
@@ -288,7 +330,7 @@ ssh-access, all you need to do is:
If you use the <CODE>-a</CODE> flag to push, all local patches which are not in If you use the <CODE>-a</CODE> flag to push, all local patches which are not in
the main repo are pushed. the main repo are pushed.
</P> </P>
<A NAME="toc15"></A> <A NAME="toc16"></A>
<H2>Apply a patch from someone else</H2> <H2>Apply a patch from someone else</H2>
<P> <P>
Use: Use:
@@ -301,16 +343,16 @@ Use:
This applies the patch to your local repository. To commit it to the This applies the patch to your local repository. To commit it to the
main repo, use <CODE>darcs push</CODE>. main repo, use <CODE>darcs push</CODE>.
</P> </P>
<A NAME="toc16"></A>
<H1>Troubleshooting</H1>
<A NAME="toc17"></A> <A NAME="toc17"></A>
<H1>Troubleshooting</H1>
<A NAME="toc18"></A>
<H2>I get the error "darcs not found" when pushing</H2> <H2>I get the error "darcs not found" when pushing</H2>
<P> <P>
If you get <CODE>darcs not found</CODE> when you try to push your changes, you If you get <CODE>darcs not found</CODE> when you try to push your changes, you
don't have darcs on your <CODE>$PATH</CODE> on the Chalmers system. See don't have darcs on your <CODE>$PATH</CODE> on the Chalmers system. See
the section above on setting up your <CODE>$PATH</CODE> on the Chalmers system. the section above on setting up your <CODE>$PATH</CODE> on the Chalmers system.
</P> </P>
<A NAME="toc18"></A> <A NAME="toc19"></A>
<H2>I get the error "(sftp) failed to fetch files."</H2> <H2>I get the error "(sftp) failed to fetch files."</H2>
<P> <P>
There seems to be a problem with how darcs 1.0.4 calls sftp, which There seems to be a problem with how darcs 1.0.4 calls sftp, which
@@ -318,7 +360,7 @@ means that normal password authentication does not work. Either use
Darcs 1.0.3 on your client, and be prepared to enter your password Darcs 1.0.3 on your client, and be prepared to enter your password
many times, or use the ssh ControlMaster feature as described above. many times, or use the ssh ControlMaster feature as described above.
</P> </P>
<A NAME="toc19"></A> <A NAME="toc20"></A>
<H2>I get the error "Not a repository: gfreposerver:..."</H2> <H2>I get the error "Not a repository: gfreposerver:..."</H2>
<P> <P>
You get this error when you have set up ControlMaster, but don't have a master You get this error when you have set up ControlMaster, but don't have a master
@@ -329,21 +371,16 @@ connection running. Start a master connection:
</PRE> </PRE>
<P></P> <P></P>
<P> <P>
If your master connection keeps dying because of inactivity, you can have it or use the <CODE>darcs-cm</CODE> script shown above.
run some program with outputs something once in a while, e.g.:
</P> </P>
<PRE>
$ ssh -M gfreposerver "bash -c 'while true; do echo -n .; sleep 30; done'"
</PRE>
<P></P>
<A NAME="toc20"></A>
<H2>How do I avoid typing in my password so many times?</H2>
<A NAME="toc21"></A> <A NAME="toc21"></A>
<H2>How do I avoid typing in my password so many times?</H2>
<A NAME="toc22"></A>
<H3>Using ssh ControlMaster</H3> <H3>Using ssh ControlMaster</H3>
<P> <P>
See above. See above.
</P> </P>
<A NAME="toc22"></A> <A NAME="toc23"></A>
<H3>Using ssh-agent</H3> <H3>Using ssh-agent</H3>
<P> <P>
<B>NOTE: the method below will not work with <CODE>momo.medic.chalmers.se</CODE></B>. <B>NOTE: the method below will not work with <CODE>momo.medic.chalmers.se</CODE></B>.
@@ -406,7 +443,7 @@ Try to use it to log in (with your own username again):
zsh:bringert:[~]&gt; zsh:bringert:[~]&gt;
</PRE> </PRE>
<P></P> <P></P>
<A NAME="toc23"></A> <A NAME="toc24"></A>
<H1>Technical Information</H1> <H1>Technical Information</H1>
<P> <P>
This section contains information about how the repository is set This section contains information about how the repository is set
@@ -436,7 +473,7 @@ The repo has this in <CODE>_darcs/prefs/defaults</CODE>:
The server which we push to has darcs 1.0.4, which is needed for The server which we push to has darcs 1.0.4, which is needed for
posthook support. posthook support.
</P> </P>
<A NAME="toc24"></A> <A NAME="toc25"></A>
<H1>Further information about Darcs</H1> <H1>Further information about Darcs</H1>
<P> <P>
For more info about what you can do with darcs, see <A HREF="http://darcs.net/manual/">http://darcs.net/manual/</A> For more info about what you can do with darcs, see <A HREF="http://darcs.net/manual/">http://darcs.net/manual/</A>

46
doc/darcs.txt
View File

@@ -172,6 +172,45 @@ somewhere.
**NOTE: You need to have a ControlMaster connection running whenever you want to access the repo using ssh.** **NOTE: You need to have a ControlMaster connection running whenever you want to access the repo using ssh.**
You may want to create a script or alias for starting the connection. You may want to create a script or alias for starting the connection.
=== Automating the ControlMaster connection ===
You can create a darcs wrapper which sets up a ControlMaster connection
if there isn't one already. Put the code below in, for example, ``~bin/darcs-cm``,
and use that program instead of ``darcs`` to work with the repository.
```
#!/bin/bash
DARCS=`which darcs`
SSH=`which ssh`
REPOSERVER=gfreposerver
if [ ! -x "$SSH" ]; then
echo "ssh ($SSH): command not found" 1>&2
exit 1
fi
if [ "$1" = "--stop" ]; then
$SSH -O exit "$REPOSERVER"
exit $?
fi
if [ ! -x "$DARCS" ]; then
echo "darcs ($DARCS): command not found" 1>&2
exit 1
fi
if ! $SSH -O check "$REPOSERVER" >& /dev/null; then
echo "Connection to $REPOSERVER is down, connecting..."
$SSH -f -M "$REPOSERVER" \
"bash -c 'while true; do echo -n .; sleep 30; done'" > /dev/null
sleep 1
fi
exec $DARCS "$@"
```
== Getting a fresh copy == == Getting a fresh copy ==
Get your copy with (all on one line): Get your copy with (all on one line):
@@ -265,12 +304,7 @@ connection running. Start a master connection:
$ ssh -M gfreposerver $ ssh -M gfreposerver
``` ```
If your master connection keeps dying because of inactivity, you can have it or use the ``darcs-cm`` script shown above.
run some program with outputs something once in a while, e.g.:
```
$ ssh -M gfreposerver "bash -c 'while true; do echo -n .; sleep 30; done'"
```
== How do I avoid typing in my password so many times? == == How do I avoid typing in my password so many times? ==