From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 18600 invoked from network); 10 Dec 2020 13:46:25 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 10 Dec 2020 13:46:25 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 73c0ad25 for ; Thu, 10 Dec 2020 08:46:23 -0500 (EST) Received: from scc-mailout-kit-01.scc.kit.edu (scc-mailout-kit-01.scc.kit.edu [129.13.231.81]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id dbd6f579 for ; Thu, 10 Dec 2020 08:46:21 -0500 (EST) Received: from hekate.asta.kit.edu ([141.3.145.153] helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1knMGw-0002U6-5s; Thu, 10 Dec 2020 14:46:20 +0100 Received: from donnerwolke.asta.kit.edu ([141.3.145.61] helo=donnerwolke.usta.de) by hekate.usta.de with esmtp (Exim 4.92.2) (envelope-from ) id 1knMGu-0003cd-Hz; Thu, 10 Dec 2020 14:46:16 +0100 Received: from athene.asta.kit.edu ([141.3.145.60] helo=athene.usta.de) by donnerwolke.usta.de with esmtp (Exim 4.84_2) (envelope-from ) id 1knMGu-0006o1-BE; Thu, 10 Dec 2020 14:46:16 +0100 Received: from localhost (athene.usta.de [local]) by athene.usta.de (OpenSMTPD) with ESMTPA id 96a2cc93; Thu, 10 Dec 2020 14:46:16 +0100 (CET) Date: Thu, 10 Dec 2020 14:46:16 +0100 From: Ingo Schwarze To: Aisha Tammy Cc: discuss@mandoc.bsd.lv Subject: Re: Help with setting up man.cgi with nginx Message-ID: <20201210134616.GF69368@athene.usta.de> References: <00b30a32-e90b-7f72-3120-63e0d38fe36a@aisha.cc> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <00b30a32-e90b-7f72-3120-63e0d38fe36a@aisha.cc> User-Agent: Mutt/1.12.2 (2019-09-21) Hi Aisha, Aisha Tammy wrote on Wed, Dec 09, 2020 at 07:06:46PM -0500: > I was trying to set up man.cgi to view my manual pages online and > haven't been able to find a lot of documentation for setting it up. Did you look at https://man.openbsd.org/man.cgi.8 ? > I managed to get the main page to load but its not able to show any > man pages, only the front page. I suggest that you inspect the web server logs. That is the usual method for debugging non-working web server setups. > I am on Gentoo and am using the nginx webserver. This sounds as if your question might be more related to how nginx works than to man.cgi(8). I have very little experience with nginx, so i fear i won't be able to provide much help for that program. > I amĀ  using the fcgiwrap for passing to man.cgi. > As man.cgi wants the /man folder to be present and nginx doesnt have chroot ??? To be honest, running a webserver without chroot in 2020 sounds rather crazy. In the design of man.cgi, Kristaps and myself did not even consider supporting non-chroot setups. It may or may not work, but i don't feel like spending time on considering whether it might work, or how. Just use a chroot, as everybody else does, and be done with it, i would say... > I had to symlink my /var/www/man to /man (as a temporary work around). > > the folder /man contains a single file - manpath.conf with just a > single line - system > > the /man/system directory contains man1/ man2/ ... folders with the > man pages in them. That sounds good as far as it goes. Did you remember to do # cd /var/www/man/ # makewhatis system after copying the manual pages into the system/man1/ system/man2/ ... directories? > But when I go to http://localhost , while I can see the main page, clicking on > any of the links man.cgi(8) or apropos(1) just shows the same page. > > Can anyone point out what I am missing. > > nginx.conf: I fear i can't reasonably comment on nginx or fcgiwrap. Yours, Ingo -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv