{"payload":{"allShortcutsEnabled":false,"fileTree":{"":{"items":[{"name":".gitignore","path":".gitignore","contentType":"file"},{"name":"Makefile","path":"Makefile","contentType":"file"},{"name":"README-ja.txt","path":"README-ja.txt","contentType":"file"},{"name":"README.txt","path":"README.txt","contentType":"file"},{"name":"agent.cpp","path":"agent.cpp","contentType":"file"},{"name":"agent.ico","path":"agent.ico","contentType":"file"},{"name":"agent.manifest","path":"agent.manifest","contentType":"file"},{"name":"agent.rc","path":"agent.rc","contentType":"file"},{"name":"agentrc.h","path":"agentrc.h","contentType":"file"},{"name":"askpass.cpp","path":"askpass.cpp","contentType":"file"},{"name":"askpass.ico","path":"askpass.ico","contentType":"file"},{"name":"askpass.manifest","path":"askpass.manifest","contentType":"file"},{"name":"askpass.rc","path":"askpass.rc","contentType":"file"},{"name":"askpassrc.h","path":"askpassrc.h","contentType":"file"},{"name":"check_dist_ver.rb","path":"check_dist_ver.rb","contentType":"file"},{"name":"misc.cpp","path":"misc.cpp","contentType":"file"},{"name":"misc.h","path":"misc.h","contentType":"file"}],"totalCount":17}},"fileTreeProcessingTime":4.574082,"foldersToFetch":[],"repo":{"id":2692524,"defaultBranch":"master","name":"win-ssh-agent","ownerLogin":"ganaware","currentUserCanPush":false,"isFork":false,"isEmpty":false,"createdAt":"2011-11-02T02:50:00.000Z","ownerAvatar":"https://avatars.githubusercontent.com/u/9438?v=4","public":true,"private":false,"isOrgOwned":false},"symbolsExpanded":false,"treeExpanded":true,"refInfo":{"name":"master","listCacheKey":"v0:1613664953.3612318","canEdit":false,"refType":"branch","currentOid":"ec687491e03ca8e993a8ed8a6b1a656c64d5ef07"},"path":"README.txt","currentUser":null,"blob":{"rawLines":["\r","\r","\t\twin-ssh-agent, win-ssh-askpass (for the cygwin openssh)\r","\r","\r","1. Introduction\r","\r","\tWith the win-ssh-agent, we can use the ssh-agent (available in\r","\tthe cygwin openssh) in the more smart way.\r","\r","\tNormally, we need to start all relevant programs, which might\r","\tneed to use the ssh, as child processes of the shell\r","\t(e.g. bash) in which you eval'ed the ssh-agent. Because, the\r","\tprograms must be able to refer to environment variables that\r","\tset by the ssh-agent.\r","\r","\tThe win-ssh-agent enables all programs to refer to the\r","\tenvironment variables of the ssh-agent, i.e. the\r","\tSSH_AUTH_SOCK. Now, we no longer need to start programs as\r","\tchild processes of the shell.\r","\r","\r","2. Install\r","\r","\tThe win-ssh-agent.exe and the win-ssh-askpass.exe should be in\r","\tthe same directory (e.g. /usr/local/bin/) .\r","\r","\t\tFor 32-bit Cygwin, you can use the attached\r","\t\twin-ssh-agent.exe and the attached\r","\t\twin-ssh-askpass.exe.\r","\r","\t\tFor 64-bit Cygwin, you need to compile sources.\r","\t\tFollow the section \"6. Compile\", then do the above\r","\t\tinstruction.\r","\r","\tInstall the cygwin openssh by the cygwin setup.exe.\r","\tI confirmed that the openssh-6.2p2-1 worked properly.\r","\r","\tThe system wide PATH environment variable must have /bin of the\r","\tcygwin (e.g. PATH=C:\\cygwin\\bin;... or PATH=C:\\cygwin64\\bin;...)\r","\r","\r","3. Run and Terminate\r","\r","\tTo run, double-click the win-ssh-agent.exe .\r","\r","\tIt asks the pass-phrases. After you fulfill them, the\r","\twin-ssh-agent stays in the notification area of the taskbar.\r","\r","\tTo terminate it, right-click the icon in the notification\r","\tarea, then choose \"Exit\".\r","\r","\r","4. Behaviors\r","\r","\tAfter the win-ssh-agent started, it will make the ssh-agent\r","\tautomatically start. And then the below environment variables\r","\twill be set up.\r","\r","\t\tSSH_AGENT_PID\tthe process ID for ssh-agent.exe\r","\t\tSSH_AUTH_SOCK\tthe socket-path for ssh-agent.exe\r","\t\tSSH_ASKPASS\tthe path of win-ssh-askpass.exe\r","\t\tDISPLAY\t\t:0\r","\r","\t(The terms of set up the DISPLAY environment variable are that\r","\tthe DISPLAY have not been set up and also then --no-DISPLAY\r","\toption was not set up at the command line of the\r","\twin-ssh-agent.)\r","\r","\tOnce this set up would be done, all application which will be\r","\tstarted through the Explorer will be able to refer to these\r","\tenvironment variables, because they are set up into the\r","\tExplorer.\r","\r","\tThe win-ssh-agent stays in the notification area of the\r","\ttaskbar and deletes each environment variable at the end of\r","\tits life.\r","\r","\t\r","5. Options of the win-ssh-agent.exe\r","\r","\t--no-ssh-agent\r","\r","\t\tIt stops to start the ssh-agent. Without this option,\r","\t\tthe ssh-agent is automatically started.\r","\r","\t--no-DISPLAY\r","\r","\t\tIt stops that the win-ssh-agent sets up automatically\r","\t\tthe DISPLAY environment variable.\r","\r","\t-i, --identity FILENAME\r","\r","\t\tIn case using more than one identity file, the\r","\t\tidentity file will be specified by this option. This\r","\t\toption can be specified more more than once.\r","\r","\t-I, --default-identity -\r","\r","\t\tIt shows dialogue which asks the pass-phrase at the time of\r","\t\tstart. This option can be specified only once.\r","\r","\t\tThe same identity files are considerd to be specified\r","\t\tas the ssh-add with no-options uses.\r","\t\t(i.e. ~/.ssh/id_rsa, ~/.ssh/id_dsa, ~/.ssh/id_ecdsa,\r","\t\t~/.ssh/id_ed25519, ~/.ssh/identity)\r","\r","\t\tIn the case of default, -I - is set up automatically.\r","\r","\t\tThis option invalidates -I FILENAME.\r","\r","\t-I, --default-identity FILENAME\r","\r","\t\tThis option works almost as same as -i. But, it shows\r","\t\ta dialogue which asks the pass-phrase at the time of\r","\t\tstart. This option can be specified multiple times.\r","\r","\t\tThis option invalidates -I -.\r","\r","\t--no-default-identity\r","\r","\t\tIt stops that -I - is set in the case of default.\r","\r","\t\tThis option invalidates -I -, and -I FILENAME.\r","\r","\t-e, --exec PROGRAM [OPTION ...]\r","\r","\t\tAfter the win-ssh-agent started, it executes the\r","\t\tPROGRAM. If the -I option is specified, it is\r","\t\texecuted after closing the pass-phrase dialogue. In\r","\t\tthe case the pass-phrase dialogue was cancelled, it\r","\t\twill not be executed.\r","\r","\t-a BIND_ADDRESS\r","\r","\t\tBind the agent to the UNIX-domain socket bind_address. The\r","\t\tdefault is $TMPDIR/ssh-XXXXXXXXXX/agent..\r","\r","\t-t LIFE\r","\r","\t\tSet a default value for the maximum lifetime of identities\r","\t\tadded to the agent. The lifetime may be specified in seconds\r","\t\tor in a time format specified in sshd_config(5). A lifetime\r","\t\tspecified for an identity with ssh-add(1) overrides this\r","\t\tvalue. Without this option the default maximum lifetime is\r","\t\tforever.\r","\r","\r","6. Compile\r","\r","\r","\tThe ssh-agent.exe and ssh-add.exe must be found in the path of\r","\tthe PATH.\r","\r","\tIf you want to re-compile, please do make.\r","\r","\t$ make clean && make && make install\r","\r","\tNOTE:\r","\t\tIf win-ssh-askpass.exe cannot run under Windows XP,\r","\t\tplease try the following commandline:\r","\r","\t\t$ make install-xp\r","\r","\r","7. Support \r","\r","\thttps://github.com/ganaware/win-ssh-agent\r","\r","\r","8. Copyright\r","\r","\tCopyright (c) 2001-2006, 2011, 2013, TAGA Nayuta \r","\tAll rights reserved.\r","\r","\tRedistribution and use in source and binary forms, with or\r","\twithout modification, are permitted provided that the\r","\tfollowing conditions are met:\r","\r","\t* Redistributions of source code must retain the above\r"," copyright notice, this list of conditions and the following\r"," disclaimer.\r","\r","\t* Redistributions in binary form must reproduce the above\r"," copyright notice, this list of conditions and the following\r"," disclaimer in the documentation and/or other materials\r"," provided with the distribution.\r","\r","\t* Neither the name of the GANAware nor the names of its\r"," contributors may be used to endorse or promote products\r"," derived from this software without specific prior written\r"," permission.\r","\r","\tTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND\r","\tCONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES,\r","\tINCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r","\tMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\r","\tDISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE\r","\tLIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\r","\tEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r","\tLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS\r","\tOF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\r","\tCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,\r","\tSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\r","\tARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF\r","\tADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r","\r","\r","9. History\r","\r","\t2016/04/12 1.10\r","\t\t* -I FILENAME can be specified multiple times.\r","\t\t* some fix\r","\r","\t2016/03/10 1.09\r","\t\t* Fixed for Cygwin 64-bit.\r","\r","\t2013/08/08 1.08\r","\t\t* \"make install-xp\" is added to build a\r","\t\t win-ssh-askpass.exe without visual-style dialogbox.\r","\t\t (Thanks to Patrick Mézard)\r","\t\t* Fixed for Cygwin 64-bit.\r","\r","\t2011/11/02 1.07\r","\t\t* This project is renamed to win-ssh-agent from win-ssh-askpass.\r","\t\t* --hide-console is removed. If you use it, it is ignored.\r","\t\t* Now, win-ssh-agent.exe does not show a console window\r","\t\t when it is executed by your double-click.\r","\t\t* Workaround for openssh 5.9p1-1.\r","\t\t* README fix\r","\t\t* some fix\r","\r","\t2011/10/14 1.06\r","\t\t* Fix sources to build on Cygwin 1.7 .\r","\t\t* Now we use visual-style dialogbox.\r","\t\t* We use more Unicode API.\r","\r","\t2006/04/02 1.05\r","\t\t* Now, win-ssh-agent set up an environment variable\r"," DISPLAY to :0 instead of localhost:0.\r","\t\t* Thanks to Ralf Hauser and Naoko, README written in\r","\t\t English is available.\r","\t\t* -a and -t are added.\r","\t\t* some bug fix for cygwin 1.5.19.\r","\r","\t2002/09/22 1.04\r","\t\t* I separated the win-ssh-agent and the win-ssh-askpass.\r","\t\t* I made a change, so that \"-I-\" will be specified in default.\r","\t\t* --hide-console is added.\r","\t\t* sample.bat was cancelled.\r","\r","\t2002/02/27 1.03\r","\t\t* Now, -e will not be executed when you cancelled the\r"," pass-phrase dialogue in the case -I and -e were\r"," simultaneously specified. (Patched by Sumio TOYAMA)\r","\t\t* sample.bat was added.\r","\r","\t2001/12/09 1.02\r","\t\t* More than one identity files can be specified.\r","\t\t* The pass-phrase dialogue may open at the beginning.\r","\t\t* A program can be executed after the start of the\r"," win-ssh-askpass.\r","\r","\t2001/11/10 1.01\r","\t\t* The link-warning were vanished when make.\r","\r","\t2001/11/04 1.00\r","\t\t* I made it.\r"],"stylingDirectives":[[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[]],"colorizedLines":null,"csv":null,"csvError":null,"dependabotInfo":{"showConfigurationBanner":false,"configFilePath":null,"networkDependabotPath":"/ganaware/win-ssh-agent/network/updates","dismissConfigurationNoticePath":"/settings/dismiss-notice/dependabot_configuration_notice","configurationNoticeDismissed":null},"displayName":"README.txt","displayUrl":"https://github.com/ganaware/win-ssh-agent/blob/master/README.txt?raw=true","headerInfo":{"blobSize":"8.14 KB","deleteTooltip":"You must be signed in to make or propose changes","editTooltip":"You must be signed in to make or propose changes","ghDesktopPath":"https://desktop.github.com","isGitLfs":false,"onBranch":true,"shortPath":"c23c51e","siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2Fganaware%2Fwin-ssh-agent%2Fblob%2Fmaster%2FREADME.txt","isCSV":false,"isRichtext":false,"toc":null,"lineInfo":{"truncatedLoc":"268","truncatedSloc":"186"},"mode":"file"},"image":false,"isCodeownersFile":null,"isPlain":false,"isValidLegacyIssueTemplate":false,"issueTemplate":null,"discussionTemplate":null,"language":"Text","languageID":372,"large":false,"planSupportInfo":{"repoIsFork":null,"repoOwnedByCurrentUser":null,"requestFullPath":"/ganaware/win-ssh-agent/blob/master/README.txt","showFreeOrgGatedFeatureMessage":null,"showPlanSupportBanner":null,"upgradeDataAttributes":null,"upgradePath":null},"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_dockerfile","releasePath":"/ganaware/win-ssh-agent/releases/new?marketplace=true","showPublishActionBanner":false},"rawBlobUrl":"https://github.com/ganaware/win-ssh-agent/raw/master/README.txt","renderImageOrRaw":false,"richText":null,"renderedFileInfo":null,"shortPath":null,"symbolsEnabled":true,"tabSize":8,"topBannersInfo":{"overridingGlobalFundingFile":false,"globalPreferredFundingPath":null,"showInvalidCitationWarning":false,"citationHelpUrl":"https://docs.github.com/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files","actionsOnboardingTip":null},"truncated":false,"viewable":true,"workflowRedirectUrl":null,"symbols":{"timed_out":false,"not_analyzed":true,"symbols":[]}},"copilotInfo":null,"copilotAccessAllowed":false,"csrf_tokens":{"/ganaware/win-ssh-agent/branches":{"post":"MWnFkdsQjqDPkP7kgAVymIuNqH3hx_Cd5cmPD3489bUB3uT9HieJHn_8jIu8qteq5T94lSmewFHher861iBuvQ"},"/repos/preferences":{"post":"RXKIXG6_0HWKdKdh4B5aiP92QW6ValOs5Dhydgdz7f2bfGIg6RPU0hs9MSR6FRUPqxIoHLIwKPVJliDCXoya2Q"}}},"title":"win-ssh-agent/README.txt at master · ganaware/win-ssh-agent"}