Bug 481

Summary: Extend man page with documentation
Product: Portable OpenSSH Reporter: Ralf Hauser <hauser>
Component: ssh-agentAssignee: OpenSSH Bugzilla mailing list <openssh-bugs>
Status: CLOSED FIXED    
Severity: enhancement Keywords: openbsd, patch
Priority: P2    
Version: -current   
Hardware: All   
OS: All   
URL: http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-agent
Bug Depends on:    
Bug Blocks: 822    
Attachments:
Description Flags
man.cgi.html patch
none
enhanced patch for ssh-agent's man.cgi.html
none
Import examples into nroff source. none

Description Ralf Hauser 2003-01-30 21:27:23 AEDT
I am normally using tcsh.

From <<If a commandline is given, this is executed as a subprocess of the agent.
     When the command dies, so does the agent.>> I understand that my shell needs
to be a child of ssh-agent.
I tried "ssh-agent -c tcsh" which didn't work. 
An example here would be great.
I understand, that in the bsh it is "eval `ssh-agent -s`"
it would be great to add this as an example for not so shell-experienced persons
like me ;) and the equivalent for *csh*.

Thanks.
Comment 1 Markus Friedl 2003-02-02 00:11:38 AEDT
do you have a patch for the manpage?
Comment 2 Ralf Hauser 2003-02-03 18:22:08 AEDT
Created attachment 216 [details]
man.cgi.html patch

Markus, as per your request. r.
Comment 3 Ralf Hauser 2003-02-19 04:46:49 AEDT
Created attachment 231 [details]
enhanced patch for ssh-agent's man.cgi.html

now covers (corrected) eval statements

and -t passwd as per http://bugzilla.mindrot.org/show_bug.cgi?id=496
Comment 4 Markus Friedl 2003-02-20 00:08:18 AEDT
please don't send patches for the html page, use the
troff source instead.
Comment 5 Ralf Hauser 2003-02-20 00:33:40 AEDT
Sure, where could I easiest get it?
http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/ssh/ssh-agent/ wasn't it,
http://www.openbsd.org/cgi-bin/cvsweb/www/openssh/ didn't look like it either,
http://www.openbsd.org/cgi-bin/cvsweb/src/share/man/man1 neither...
Comment 7 Darren Tucker 2004-05-12 14:35:44 AEST
Created attachment 635 [details]
Import examples into nroff source.
Comment 8 Darren Tucker 2004-05-13 16:45:57 AEST
This has been fixed, thanks.  The text now reads:

     There are two main ways to get an agent set up: The first is that the
     agent starts a new subcommand into which some environment variables are
     exported, eg ssh-agent xterm &.  The second is that the agent prints the
     needed shell commands (either sh(1) or csh(1) syntax can be generated)
     which can be evalled in the calling shell, eg eval `ssh-agent -s` for
     Bourne-type shells such as sh(1) or ksh(1) and eval `ssh-agent -c` for
     csh(1) and derivatives.