According to the Samba documentation, the manpages are supposed to be installed with Samba. Quote: docs/manpages: You don't need to worry about these yet; during the installation, the files will be installed so that you can use the man command to read them. But you can take a look in the directory to see which manpages are available. My problem: Samba4 on 64bit Fedora 17 will not install the manpages, other than a bare-bones "samba" page. Specifically, it will not install the "smb.conf" page. What I tried: I tried reinstalling Samba with the following commands: sudo yum reinstall samba4 sudo yum reinstall samba4-devel sudo yum reinstall samba4-common sudo yum reinstall samba4-libs No luck - "man smb.conf" still gave a "No manual entry for smb.conf" error. After googling some more, I found the "make installman" command. So I downloaded the source for Samba4, and ran ./configure, make, and then make installman. That returned the following error: No rule to make target `installman' Wow, this is a PITA. Googling for that error didn't reveal anything helpful. Next, I reinstalled from source (which I just finished compiling), thinking the manpages might be installed with a full, manual installation: sudo make install. Still no luck - "man smb.conf" still gives the same error. During my googling, I remember reading about pointing the "man" command to the location of the manpages. So, I used the following command to look for the man pages: locate smb|grep man Next, "man man" told me the location of the local man config file. I wasn't sure which PATH to use, so I added these to /etc/man_db.conf: MANPATH_MAP /bin /usr/local/samba/share/man MANPATH_MAP /usr/bin /usr/local/samba/share/man MANPATH_MAP /sbin /usr/local/samba/share/man That finally fixed my manpage problem. Why must the Samba man pages be so $#@%#! difficult to install? Every other Linux application that I have ever installed automatically installs the man pages. Why can't Samba do the same thing? PS: This email would be a lot easier to read if mailing lists supported <code> tags, or if Samba had a forum or bulletin board. :)
> Wow, this is a PITA. Googling for that error didn't reveal anything helpful. >I had the exact same problem. Plus, all my attempts at producing a .rpm package failed because the provided .spec template has serious problems, namely with the... man pages. Or maybe the flaw is with me, since I don't know how to write a samba.spec from scratch?> > PS: This email would be a lot easier to read if mailing lists > supported <code> tags, or if Samba had a forum or bulletin board. :)Yes, a forum would be a great idea!
Andrew Bartlett
2012-Dec-19 22:54 UTC
[Samba] Limitations in packages of Samba 4.0 (particularly pre-releases)
On Fri, 2012-12-14 at 19:05 -0500, Tom McArthur wrote:> According to the Samba documentation, the manpages are supposed to be > installed with Samba. Quote: > > docs/manpages: You don't need to worry about these yet; during the > installation, the files will be installed so that you can use the man > command to read them. But you can take a look in the directory to see > which manpages are available. > > My problem: > > Samba4 on 64bit Fedora 17 will not install the manpages, other than a > bare-bones "samba" page. Specifically, it will not install the > "smb.conf" page. > > What I tried: > > I tried reinstalling Samba with the following commands: > > sudo yum reinstall samba4 > sudo yum reinstall samba4-devel > sudo yum reinstall samba4-common > sudo yum reinstall samba4-libs > > No luck - "man smb.conf" still gave a "No manual entry for smb.conf" error.The samba4 on Fedora 17 is not a complete Samba4, it is just some parts (libraries) to support OpenChange and FreeIPA. Therefore it does not include manpages for the parts that are still based on Samba 3.x, which was the official release of Samba at the time of the Fedora 17 release. You can, as you noted before, install from source. Just /usr/local/samba won't be in your path, it won't be in the man path, as you noticed. Any further issues with the deficiencies in the Fedora packages (like the lack of AD DC support) need to be addressed to Fedora, as we don't provide the packages. The same applies to Debian/Ubuntu, which has for the same reason packaged pre-releases of Samba 4.0 to support OpenChange. These packages are also not full packages of the final Samba 4.0. On samba-technical I've posted a link to the start of the packaging work I've done to fix that. Andrew Bartlett -- Andrew Bartlett http://samba.org/~abartlet/ Authentication Developer, Samba Team http://samba.org
L.P.H. van Belle
2012-Dec-20 07:59 UTC
[Samba] Limitations in packages of Samba 4.0 (particularly pre-releases)
Hai Andrew, you wrote>The same applies to Debian/Ubuntu, which has for the same reason >packaged pre-releases of Samba 4.0 to support OpenChange. These >packages are also not full packages of the final Samba 4.0. On >samba-technical I've posted a link to the start of the packaging work >I've done to fix that. >Can you provide the link for me, so i can look at it. Im looking atm to rebuild the debian experimental samba4 back to squeeze or im going to use the sernet packages. I like the sernet appliance packages because of the integrated zarafa schemas. I saw samba4 has mismatch with the debian stable samba3, do you know is this also applies for samba 3.6.6 ( from backports ) Best regards, Louis>-----Oorspronkelijk bericht----- >Van: abartlet at samba.org [mailto:samba-bounces at lists.samba.org] >Namens Andrew Bartlett >Verzonden: woensdag 19 december 2012 23:55 >Aan: Tom McArthur >CC: samba at lists.samba.org >Onderwerp: [Samba] Limitations in packages of Samba 4.0 >(particularly pre-releases) > >On Fri, 2012-12-14 at 19:05 -0500, Tom McArthur wrote: >> According to the Samba documentation, the manpages are >supposed to be >> installed with Samba. Quote: >> >> docs/manpages: You don't need to worry about these yet; during the >> installation, the files will be installed so that you can >use the man >> command to read them. But you can take a look in the >directory to see >> which manpages are available. >> >> My problem: >> >> Samba4 on 64bit Fedora 17 will not install the manpages, >other than a >> bare-bones "samba" page. Specifically, it will not install the >> "smb.conf" page. >> >> What I tried: >> >> I tried reinstalling Samba with the following commands: >> >> sudo yum reinstall samba4 >> sudo yum reinstall samba4-devel >> sudo yum reinstall samba4-common >> sudo yum reinstall samba4-libs >> >> No luck - "man smb.conf" still gave a "No manual entry for >smb.conf" error. > >The samba4 on Fedora 17 is not a complete Samba4, it is just some parts >(libraries) to support OpenChange and FreeIPA. Therefore it does not >include manpages for the parts that are still based on Samba 3.x, which >was the official release of Samba at the time of the Fedora 17 release. > >You can, as you noted before, install from source. >Just /usr/local/samba won't be in your path, it won't be in the man >path, as you noticed. > >Any further issues with the deficiencies in the Fedora packages (like >the lack of AD DC support) need to be addressed to Fedora, as we don't >provide the packages. > >The same applies to Debian/Ubuntu, which has for the same reason >packaged pre-releases of Samba 4.0 to support OpenChange. These >packages are also not full packages of the final Samba 4.0. On >samba-technical I've posted a link to the start of the packaging work >I've done to fix that. > >Andrew Bartlett > >-- >Andrew Bartlett >http://samba.org/~abartlet/ >Authentication Developer, Samba Team http://samba.org > > >-- >To unsubscribe from this list go to the following URL and read the >instructions: https://lists.samba.org/mailman/options/samba > >
Hi, I'm working on Ubuntu 12.04, and compiling from the git source. I created the html version of the manuals like this (my samba-master tree is ~/samba-master). sudo apt-get install docbook-utils xsltproc cd ~/samba-master/docs-xml cp Makefile.settings.in Makefile.settings I edited Makefile.settings, and changed 2 lines: XSLTPROC = xsltproc # was @XSLTPROC@ . . . OUTPUTDIR = /usr/local/samba/share # was output sudo make htmlman sudo make manpages This creates /usr/local/samba/share/htmldocs/manpages/index.html and many other pages in that same directory. It also creates /usr/local/samba/share/manpages. I can get at the html files using the browser. I haven't had success accessing the manpages using the man system yet. Endel -----Original Message----- From: samba-bounces at lists.samba.org [mailto:samba-bounces at lists.samba.org] On Behalf Of Tom McArthur Sent: Friday, December 14, 2012 7:06 PM To: samba at lists.samba.org Subject: [Samba] Installing manpages According to the Samba documentation, the manpages are supposed to be installed with Samba. Quote: docs/manpages: You don't need to worry about these yet; during the installation, the files will be installed so that you can use the man command to read them. But you can take a look in the directory to see which manpages are available. My problem: Samba4 on 64bit Fedora 17 will not install the manpages, other than a bare-bones "samba" page. Specifically, it will not install the "smb.conf" page. What I tried: I tried reinstalling Samba with the following commands: sudo yum reinstall samba4 sudo yum reinstall samba4-devel sudo yum reinstall samba4-common sudo yum reinstall samba4-libs No luck - "man smb.conf" still gave a "No manual entry for smb.conf" error. After googling some more, I found the "make installman" command. So I downloaded the source for Samba4, and ran ./configure, make, and then make installman. That returned the following error: No rule to make target `installman' Wow, this is a PITA. Googling for that error didn't reveal anything helpful. Next, I reinstalled from source (which I just finished compiling), thinking the manpages might be installed with a full, manual installation: sudo make install. Still no luck - "man smb.conf" still gives the same error. During my googling, I remember reading about pointing the "man" command to the location of the manpages. So, I used the following command to look for the man pages: locate smb|grep man Next, "man man" told me the location of the local man config file. I wasn't sure which PATH to use, so I added these to /etc/man_db.conf: MANPATH_MAP /bin /usr/local/samba/share/man MANPATH_MAP /usr/bin /usr/local/samba/share/man MANPATH_MAP /sbin /usr/local/samba/share/man That finally fixed my manpage problem. Why must the Samba man pages be so $#@%#! difficult to install? Every other Linux application that I have ever installed automatically installs the man pages. Why can't Samba do the same thing? PS: This email would be a lot easier to read if mailing lists supported <code> tags, or if Samba had a forum or bulletin board. :) -- To unsubscribe from this list go to the following URL and read the instructions: https://lists.samba.org/mailman/options/samba