April 2007 - Darwin-dev - lists.apple.com

Re: XCode man pages (to replace standard man pages)
by Jordan K. Hubbard 14 Apr '07

14 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com

1 0

Re: XCode man pages (to replace standard man pages)
by Philip Q 14 Apr '07

14 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com Dkim-signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:reply-to:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; b=iwuIAg8KxS9xr6jLQiQJsna/lO7EjoLrUiemouJs94txTTYS9MDQx4SalF277OruMLsZqSbXHbCiBAfGJK2/kwwthvYx6UIsGiClpgRro7DzeEFBOkh0lVkXCq1565VAzuf8oUB/Je6p9MU/Mz257TR1ouZCTxyUteljOsNTKR0= Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:reply-to:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth; b=V8seUwtZrroi9dZ5R+FWD8WGYZRZlznPxp7YqozKni/T5GJyCBohHqMSBXu+Q/KeGhgT4J9udx4LmhW/qLrn8GeOApMLUxB7GC+FsQo8IFVrqSk+NM5DkvqEuGOErtRl7Hyc1hGWdxj7Bm+2paXhwS9XhW92F7rHmK5ycS1fG0E= 1) are the man pages that the xCode documentation window shows in a form that could be accessed outside of xCode? The files are generated using rman, located in -- /Library/Application Support/Apple/Developer Tools/Plug-ins/DocViewerPlugIn.xcplugin/Contents/Resources/ (The man page for it comes with X11) I can't find any other man sources on my system, and the output of man and Xcode/rman look identical (my copy of printf(3) does have long long in it). I do find out-of-date or incomplete man pages *incredibly* frustrating, and the suggestion that Google is a viable alternative to maintaining man pages just seems completely ignorant. However, removing them would just make the problem worse (which is worse -- incomplete documentation, or no documentation?) -Phil _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… On 14/04/07, David Hoerl <dhoerl(a)mac.com> wrote: This email sent to site_archiver(a)lists.apple.com

1 0

Re: XCode man pages (to replace standard man pages)
by Jeremiah Dabney 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com

1 0

Re: XCode man pages (to replace standard man pages)
by Timothy D. Keanini Sr. 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com Domainkey-signature: a=rsa-sha1; q=dns; c=nofws; s=dk20050327; d=earthlink.net; b=si77iRmJGOK790GeU2Lh6lEA+gdXIexOCTsjHMqB0utbWpqFPuk6m+fTReUHyUFS; h=Received:In-Reply-To:References:Mime-Version:Content-Type:Message-Id:Cc:From:Subject:Date:To:X-Mailer:X-ELNK-Trace:X-Originating-IP; _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com

1 0

Re: XCode man pages (to replace standard man pages)
by John Davidorff Pell 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com Dkim-signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:in-reply-to:references:mime-version:content-type:message-id:cc:from:subject:date:to:x-mailer; b=iRJVIIgRGIVBowJHNLwqrYNvYCfQQKlNNXg+o1g06Nzp0XEXYJwvFTDmKd71vqQPsuX4bWDxUp4gVXwjKDlGatnB1JH2R8vOBfYUSAT+5c4Juy+kQGqKDsXqwk2zpkCY8cn12+PftKiatohFTDlSZeCnGst9MipUGFu1UC0hsGE= Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:in-reply-to:references:mime-version:content-type:message-id:cc:from:subject:date:to:x-mailer; b=uX27oo4m+unJsrQZ/G5hmYz208TA8yHSZKV1CS2zvQk9fx0FfjRQt4BFO8EQRF3YQ63uBYXrbl5vzro2zF8T9AlfZL3eotCfhAMhaUkzJiz4S/Ow6bs/rkA41/ir/DiRSV+M4dUoBAXqMLcUiM2YemPjnjJPZGb1rInb8iyuLVk= Hi, JP On Apr 13, 2007, at 1:22 PM, David Hoerl wrote: _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com I think that Xcode just translates the man pages present in the system. If you open the printf man page in Xcode and in Terminal, they should be identical... are they not? Abstract: Apple should remove all man pages, and replace man with something that can read the man pages contained in XCode (but where are the pages???) -- "They [our enemies] never stop thinking about new ways to harm our country and our people, and neither do we. We must never stop thinking about how best to offend our country." - George W. Bush (August 5, 2004) smime.p7s

1 0

XCode man pages (to replace standard man pages)
by David Hoerl 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com --- So, the questions are: --- David _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… Abstract: Apple should remove all man pages, and replace man with something that can read the man pages contained in XCode (but where are the pages???) The standard man pages (obtained by running "man" from the command line are woefully out of date, and often are incorrect or missing information. I have dutifully submitted a few documentaion bugs on this, but was recently stunned when I read the reply to my latest submission (where I had suggested a one line addition to help future programmers find information that it took me 1/2 day to find). In essence, the reply was its not necessary, develops can always use google to find this information. Well, I HAD used google, but not the suggested "correct" string that got the correct hit. In my googling I found other people on this list and the darwin-users list who had also tried to get the same info and failed, so I knew it just wasn't me. rdar://5119334 Later, I was doing a simple make on the command line, and needed a printf format question answered. I did a "man 3 printf" and found it's incredibly out of date - it doesn't even have long long in it. Now, I happen to spend a lot of time in Terminal every day, and I often use "apropos" to find section 2 or section 3 functions. But once I have the page open, I really cannot count on the information being accurate as the pages are so out of date. So, I entered another bug, rdar://5128510 that suggests that Apple just get rid of all the man pages if they aren't going to keep them current. Really, if the company position is that these are not going to ever get updated, why leave them around for people like me to use, potentially incorrectly? I got a nice response to this bug, saying it would be forwarded to the appropriate group for discussion. Then today, it occurred to me that I could just write my own routine to output whatever XCode is using, so I can get the info from the terminal. So I went poking around trying to find printf(3). If you open this with the xCode document browser, you get what looks to be a temporary .html file that was translated from a man page format (open the page in the doc window, then right click and open it in a separate pane, then cmd-click on the icon at the top of the window). I did a "find /Developer -name '*printf*' -print" and all I get are printf.h files. 1) are the man pages that the xCode documentation window shows in a form that could be accessed outside of xCode? 2) if so, is there something that can already access them from the command line? 3) will apropos work with these files, or is there a similar tool that could do it? I posted to this group and not users, since its mostly developers, and non-cocoa developers, that want terminal access to man pages. In particular, xCode does not provide a way to search JUST man pages as apropos does, and I imagine its not just me that has found apropos very useful in locating information. if you feel strongly about this issue you could enter your own bug and reference the second rdar bug above. This email sent to site_archiver(a)lists.apple.com

1 0

Re: Redirecting Output for a fork()'d Process
by David Alger 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com

1 0

Re: Redirecting Output for a fork()'d Process
by David Alger 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… This email sent to site_archiver(a)lists.apple.com

1 0

Re: launchd agent for securing mail through ssh tunnel
by James Peach 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com Dkim-signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=iyJpN9vOawvti1SuNqw2H+CgigAiiELcSTiUfxOQZRuDdGMBtHp3LSPgtUxsa0s+cSHDwc7Wi2imrzQJuRCT72i6/whsJMKQmysYzmQm9Q1EFT9vbY7mNoBlhMm4FJSnejXE/vB5ES6OWXl3p5ZApDB2XXoZXrFTBcic96AU8wE= Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=gXsi3R9rwsCUVacC1zprbMBi2YqTMZmQ3wjPMP/ictSm3T56w3Kj8Z5FWUZ5k8f8DetyQTc2AKT80cSuHCSmRjo2wJCq/V5Dcz2lmqXg3tEJwACz+RM1a6Qc32y+BF3JiFGb9So5tfxZjozldFly3XHwe8CRVB3hjoD/L1BdWxc= Hi, I use to read email through an ssh tunnel and I want to turn the task into an on-demand launchd user agent. So far, I have come out with the following, "nearly working", solution: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http:// www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>my.smtp.server</string> <key>OnDemand</key> <true/> <key>Program</key> <string>/usr/bin/ssh</string> <key>ProgramArguments</key> <array> <string>ssh</string> <string>-i</string> <string>/Users/myself/.ssh/my-ssh-key</string> <string>-l</string> <string>myself</string> <string>-N</string> <string>-q</string> <string>-T</string> <string>-o</string> <string>Protocol=2</string> <string>-o</string> <string>ConnectionAttempts=3</string> <string>-o</string> <string>ServerAliveCountMax=3</string> <string>-o</string> <string>ServerAliveInterval=5</string> <string>-o</string> <string>ExitOnForwardFailure=yes</string> <string>-L</string> <string>1200:localhost:25</string> <string>my.smtp.server</string> </array> <key>RunAtLoad</key> <false/> <key>ServiceDescription</key> <string>SSH tunnel from localhost:1200 to my.smtp.server:25</string> <key>Sockets</key> <dict> <key>Listeners</key> <dict> <key>SockServiceName</key> <string>1200</string> <key>SockType</key> <string>stream</string> </dict> </dict> </dict> </plist> I have a couple of problems, though: 1) The first email sent during a session correctly triggers the ssh tunnel on, but the mail client (I have tried with Apple Mail and Thunderbird) hangs on "Connecting to localhost...". If I stop sending the email and try again (now the tunnel is already active) the mail is sent. Subsequent messages are also sent without any problem. Ar you sure that ssh isn't prompting? 2) When I pull out the network cable (e.g., because I change location), ssh quits after a while (see options ServerAliveInterval and ServerAliveCountMax); it is respawned by launchd, however, no matter how long it has been running. Since there is no network available, ssh exits again, and so repearedly until the job is eventually removed. So, I have to unload/load the plist when I connect the cable again. Remove the RunAtLoad key? I use this with Mail.app, and it works just fine: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>my.mail.service</string> <key>Program</key> <string>/usr/bin/ssh</string> <key>ProgramArguments</key> <array> <string>/usr/bin/ssh</string> <string>-L</string> <string>9025:mailserver:25</string> <string>jpeach@mailserver</string> <string>imapd</string> </array> <key>inetdCompatibility</key> <dict> <key>Wait</key> <false/> </dict> <key>Sockets</key> <dict> <key>Listeners</key> <dict> <key>SockNodeName</key> <string>localhost</string> <key>SockServiceName</key> <integer>9220</integer> <key>SockType</key> <string>stream</string> <key>SockFamily</key> <string>IPv4</string> </dict> </dict> <key>Debug</key> <true/> </dict> </plist> -- James Peach | jorgar(a)gmail.com _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… On 13/04/07, Nicola Vitacolonna <vitacolo(a)dimi.uniud.it> wrote: This email sent to site_archiver(a)lists.apple.com

1 0

Re: [APPL:DarwinDev] launchd agent for securing mail through ssh tunnel
by Nicola Vitacolonna 13 Apr '07

13 Apr '07

site_archiver(a)lists.apple.com Delivered-To: darwin-dev(a)lists.apple.com On 13/apr/07, at 13:51, Jay A. Kreibich wrote: Hi, I use to read email through an ssh tunnel and I want to turn the task into an on-demand launchd user agent. So far, I have come out with the following, "nearly working", solution: I have a couple of problems, though: 1) The first email sent during a session correctly triggers the ssh tunnel on, but the mail client (I have tried with Apple Mail and Thunderbird) hangs on "Connecting to localhost...". If I stop sending the email and try again (now the tunnel is already active) the mail is sent. Subsequent messages are also sent without any problem. This isn't as simple as it sounds. The problem is that "servers" (defined, for the purpose of this conversation, as anything that allows incoming network connections; in this case the local end of the ssh tunnel) that want to run "on demand" must be written in a special way. This is true of launchd, it is also true of launchd's predecessors, such as inetd and xinetd. Google for "ssh tunnel inetd" to get some ideas on how people have worked around this. Ok, I have found that, with xinetd, you can do something like: nc localhost smtp [...] <key>OnDemand</key> <true/> <key>ProgramArguments</key> <array> <string>/usr/bin/ssh</string> <string>-i</string> <string>/Users/myself/.ssh/my-key</string> <string>-q</string> <string>-T</string> <string>myself(a)my.mail.server.com</string> </array> <key>RunAtLoad</key> <false/> <key>Sockets</key> <dict> <key>Listeners</key> <dict> <key>SockServiceName</key> <string>smtp</string> <key>SockType</key> <string>stream</string> </dict> </dict> <key>inetdCompatibility</key> <dict> <key>Wait</key> <true/> </dict> </dict> </plist> Nicola _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-dev mailing list (Darwin-dev(a)lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-dev/site_archiver%40lists.app… On Fri, Apr 13, 2007 at 12:13:44PM +0200, Nicola Vitacolonna scratched on the wall: In short, the problem is that launchd has control over the incoming network connection. When it detects an incoming connection (e.g. your mail program) it launches the defined on-demand program (your ssh tunnel). But after that it done, it needs some way to plumb together the network connection and the newly launched program. This requires an alternate input/output method in the on-demand server application. While sshd (the normal server daemon) supports this mode (-i), the ssh client does not. So your first connection triggers the startup of the tunnel, but it doesn't actually work, since the plumbing can't be connected correctly. The tunnel has started up, however, so subsequent connections work as expected. service smtp { socket_type = stream protocol = tcp wait = no user = root disable = no server = /usr/bin/ssh server_args = -q -T -i /Users/myself/.ssh/my-key myself(a)my.mail.server.com groups = yes bind = 127.0.0.1 } redirecting the connection to the smtp port by issuing a remote command like (or socket localhost smtp). I have setup my public key so that my ssh connection is forwarded to my mail server, but in no way I can simulate the above with launchd. Is that possible at all? The nearest I can imagine is along these lines: with the disadvantage that it must be run as root, because it is listening on port 25. But that does not work for me. This email sent to site_archiver(a)lists.apple.com

1 0