[gentoo-user] Ebuild hacking howto

[gentoo-user] Ebuild hacking howto

[James]

Hello,

Is the link below the best "howto" guide as to using
an existing ebuild to hack a new ebuild? JFFNMS has
been languishing despite repeated requests for a version
bump; so I'm taking the plunge and going to update it
on one of my systems.....

http://en.gentoo-wiki.com/wiki/Creating_an_Updated_Ebuild


Also, I found this guide:

http://devmanual.gentoo.org/
and 
man 5 ebuild


Any other documents I should reference before
attempinging to update an ebuild on my own
person overlay dir?

Comments and ideas are most welcome....


James

[gentoo-user] Re: Ebuild hacking howto

[James]

James <wireless <at> tampabay.rr.com> writes:


> Any other documents I should reference before
> attempinging to update an ebuild on my own
> person overlay dir?

What about this link: rpm --> ebuild ?
a tool that generates an ebuild from a
rpm package?

http://devmanual.gentoo.org/ebuild-writing/functions/
src_unpack/rpm-sources/index.html


Does this work?
Am I miss interpreting the .rpm to ebuild conversion
process?

Anyone with any experience with this approach?
(there is a robust and current rpm for jffnms)


James

Re: [gentoo-user] Ebuild hacking howto

[Michael Orlitzky]

On 02/25/2011 08:13 AM, James wrote:
> Hello,
> 
> Is the link below the best "howto" guide as to using
> an existing ebuild to hack a new ebuild? JFFNMS has
> been languishing despite repeated requests for a version
> bump; so I'm taking the plunge and going to update it
> on one of my systems.....
> 
> http://en.gentoo-wiki.com/wiki/Creating_an_Updated_Ebuild
> 
> 
> Also, I found this guide:
> 
> http://devmanual.gentoo.org/
> and 
> man 5 ebuild
> 
> 
> Any other documents I should reference before
> attempinging to update an ebuild on my own
> person overlay dir?
> 
> Comments and ideas are most welcome....
> 

This has some good information:

  http://overlays.gentoo.org/proj/sunrise/wiki/CodingStandards

and like it says at the bottom, many projects will have their own
development documentation.

Aside from that, help is always (well, when the devs are awake)
available on IRC:

  #gentoo-dev-help (what it says)
  #gentoo-sunrise (most people here are writing/reviewing ebuilds)

Re: [gentoo-user] Ebuild hacking howto

[Mark Shields]

[-- Attachment #1.1: Type: text/plain, Size: 3603 bytes --]

On Fri, Feb 25, 2011 at 8:13 AM, James <wireless@tampabay.rr.com> wrote:

> Hello,
>
> Is the link below the best "howto" guide as to using
> an existing ebuild to hack a new ebuild? JFFNMS has
> been languishing despite repeated requests for a version
> bump; so I'm taking the plunge and going to update it
> on one of my systems.....
>
> http://en.gentoo-wiki.com/wiki/Creating_an_Updated_Ebuild
>
>
> Also, I found this guide:
>
> http://devmanual.gentoo.org/
> and
> man 5 ebuild
>
>
> Any other documents I should reference before
> attempinging to update an ebuild on my own
> person overlay dir?
>
> Comments and ideas are most welcome....
>
>
> James
>
>
> Saw that you linked to the "creating an updated ebuild" from gentoo-wiki,
so what I say may overlay quite a bit, but hear me out:

It depends on how the ebuild is built.  If it references the version by the
ebuild file name, which is very common, you can create an overlay for the
ebuild, copy the ebuild to it, rename the ebuild file to have the new
version number as part of it, digest the ebuild, make sure the overlay is
listed in your make.conf file, then try to emerge it.  I did this with
Webmin.  Yes, I know it's masked and new versions have effectively been
dropped from portage; but I use it, and it worked fine.

Maybe I should break it down a little:

Create the appropriate directory in an overlay dir.  For Webmin, I had to
create app-admin, then webmin:

# mkdir -p /usr/local/portage/overlay/app-admin/webmin
mark@allanon /usr/local/portage/overlay/app-admin/webmin $ pwd
/usr/local/portage/overlay/app-admin/webmin

I then copied webmin-1.510.ebuild from the official portage tree,
 /usr/portage/app-admin/webmin, to it's new location and filename:

# cp /usr/portage/app-admin/webmin/webmin-1.510.ebuild
/usr/local/portage/overlay/app-admin/webmin/webmin-1.530.ebuild

Then digest the ebuild to generate a manifest, otherwise portage will
complain when you try to emerge it:

# cd /usr/local/portage/overlay/app-admin/webmin
# ebuild webmin-1.530.ebuild digest

Now add the overlay to your make.conf:

PORTDIR_OVERLAY="/usr/local/portage/overlay"

If you're using EIX to sync/search portage, you'll need to run eix-update
after doing this.  Now try to emerge the newest Webmin, but first you have
to unmask it.  I like to use autounmask for that:

Create your package.???* directories (or files) in /etc/portage (I like the
dir option), if you don't already have them:

# for a in keywords unmask use; do mkdir -p /etc/portage/package.${a}; done

If you just want the files:

# for a in keywords unmask use; do touch /etc/portage/package.${a}; done

Emerge autounmask if you don't have it:

# emerge app-portage/autounmask

Then unmask Webmin 1.530:

# autounmask =app-admin/webmin-1.530

Now we can emerge it!

# emerge -av =app-admin/webmin-1.530


I've done this on 3 servers to get Webmin on them, and have used this setup
every time.

Chances are the ebuild you want to use may be this simple.

Ok, so I scrolled down and saw your reply mentioning the program, jffnms.
 What I did with Webmin can all most be done exactly the same with jffnms,
except you need to modify a line of the ebuild to point to *.tgz instead of
*.tar.gz.  When I did this, I was able to successfully fetch the gzipped tar
file from Sourceforge.

You can use sed to correct it:

sed -i -e 's/.tar.gz/.tgz/g'
/usr/local/portage/overlay/net-analyzer/jffnms/jffnms-0.8.5.ebuild

Or download the ebuild I've attached, follow the link you references to
create the overlay dir/add to make.conf, etc.

That should work.  Let me know how it goes.

[-- Attachment #1.2: Type: text/html, Size: 4961 bytes --]

[-- Attachment #2: jffnms-0.8.5.ebuild --]
[-- Type: application/octet-stream, Size: 2207 bytes --]

# Copyright 1999-2008 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: /var/cvsroot/gentoo-x86/net-analyzer/jffnms/jffnms-0.8.3-r2.ebuild,v 1.2 2008/02/02 15:34:25 hollow Exp $

inherit depend.apache eutils depend.php

DESCRIPTION="Network Management and Monitoring System."
HOMEPAGE="http://www.jffnms.org/"
SRC_URI="mirror://sourceforge/${PN}/${P}.tgz"

LICENSE="GPL-2"
SLOT="0"
KEYWORDS="~x86"
IUSE="mysql postgres snmp"

DEPEND="net-analyzer/rrdtool
	media-libs/gd
	dev-php/PEAR-PEAR
	net-analyzer/net-snmp
	sys-apps/diffutils
	app-mobilephone/smsclient"

RDEPEND="${DEPEND}
	media-gfx/graphviz
	net-analyzer/nmap
	net-analyzer/fping"

need_apache
need_php_cli

pkg_setup() {
	local flags="pcre session snmp sockets wddx"
	use mysql && flags="${flags} mysql"
	use postgres &&	flags="${flags} postgres"

	if ! PHPCHECKNODIE="yes" require_php_with_use ${flags} \
		|| ! PHPCHECKNODIE="yes" require_php_with_any_use gd gd-external ; then
		eerror
		eerror "${PHP_PKG} needs to be re-installed with all of the following"
		eerror "USE flags enabled:"
		eerror
		eerror "${flags}"
		eerror
		eerror "as well as any of the following USE flags enabled:"
		eerror
		eerror "gd or gd-external"
		eerror
		die "Re-install ${PHP_PKG} with ${flags} and either gd or gd-external"
	fi

	enewgroup jffnms
	enewuser jffnms -1 /bin/bash -1 jffnms,apache
}

src_unpack() {
	unpack ${A}
	cd "${S}"

	# Fixes Multiple vulnerabilities bug #192240
	epatch "${FILESDIR}"/${P}-misc-security-fixes.patch
}

src_install(){
	INSTALL_DIR="/opt/${PN}"
	IMAGE_DIR="${D}${INSTALL_DIR}"

	dodir "${INSTALL_DIR}"
	cp -r * "${IMAGE_DIR}" || die
	rm -f "${IMAGE_DIR}/LICENSE"

	# Clean up windows related stuff
	rm -f "${IMAGE_DIR}/*.win32.txt"
	rm -rf "${IMAGE_DIR}/docs/windows"
	rm -rf "${IMAGE_DIR}/engine/windows"

	chown -R jffnms:apache "${IMAGE_DIR}" || die
	chmod -R ug+rw "${IMAGE_DIR}" || die

	elog "${PN} has been partialy installed on your system. However you"
	elog "still need proceed with final installation and configuration."
	elog "You can visit http://www.gentoo.org/doc/en/jffnms.xml in order"
	elog "to get detailed information on how to get jffnms up and running."
}

Re: [gentoo-user] Ebuild hacking howto

[Mick]

[-- Attachment #1: Type: Text/Plain, Size: 948 bytes --]

On Saturday 26 February 2011 00:43:43 Mark Shields wrote:

> Saw that you linked to the "creating an updated ebuild" from gentoo-wiki,
> 
> so what I say may overlay quite a bit, but hear me out:
> 
> It depends on how the ebuild is built.  If it references the version by the
> ebuild file name, which is very common, you can create an overlay for the
> ebuild, copy the ebuild to it, rename the ebuild file to have the new
> version number as part of it, digest the ebuild, make sure the overlay is
> listed in your make.conf file, then try to emerge it.  I did this with
> Webmin.  Yes, I know it's masked and new versions have effectively been
> dropped from portage; but I use it, and it worked fine.

Not related to the OP's question, but couldn't stop myself from asking:

Why is/was webmin dropped from portage?

I saw bug 348432 for webmin-1.530, but other than offering an ebuild it didn't 
say. 
-- 
Regards,
Mick

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-user] Ebuild hacking howto

[Dale]

Mick wrote:
>
> Not related to the OP's question, but couldn't stop myself from asking:
>
> Why is/was webmin dropped from portage?
>
> I saw bug 348432 for webmin-1.530, but other than offering an ebuild it didn't
> say.
>    

 From gentoo-dev:

# Diego E. Pettenò<flameeyes@gentoo.org>  (10 Aug 2010)
#  on behalf of QA team
#
# Breaks about any QA policy regarding not touching
# live filesystem as it writes to LVM configuration,
# cron configuration, current-running kernel modules, RPM
# library, ...
#
# Removal on 2010-10-09
app-admin/webmin

That help?

Dale

:-)  :-)

Re: [gentoo-user] Ebuild hacking howto

[Mick]

[-- Attachment #1: Type: Text/Plain, Size: 720 bytes --]

On Saturday 26 February 2011 14:56:35 Dale wrote:
> Mick wrote:
> > Not related to the OP's question, but couldn't stop myself from asking:
> > 
> > Why is/was webmin dropped from portage?
> > 
> > I saw bug 348432 for webmin-1.530, but other than offering an ebuild it
> > didn't say.
> 
>  From gentoo-dev:
> 
> # Diego E. Pettenò<flameeyes@gentoo.org>  (10 Aug 2010)
> #  on behalf of QA team
> #
> # Breaks about any QA policy regarding not touching
> # live filesystem as it writes to LVM configuration,
> # cron configuration, current-running kernel modules, RPM
> # library, ...
> #
> # Removal on 2010-10-09
> app-admin/webmin
> 
> That help?

Yes, thank you.  :)

-- 
Regards,
Mick

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-user] Ebuild hacking howto

[Marc Joliet]

[-- Attachment #1: Type: text/plain, Size: 935 bytes --]

Am Sat, 26 Feb 2011 16:28:35 +0000
schrieb Mick <michaelkintzios@gmail.com>:

> On Saturday 26 February 2011 14:56:35 Dale wrote:
> > Mick wrote:
> > > Not related to the OP's question, but couldn't stop myself from asking:
> > > 
> > > Why is/was webmin dropped from portage?
> > > 
> > > I saw bug 348432 for webmin-1.530, but other than offering an ebuild it
> > > didn't say.
> > 
> >  From gentoo-dev:
> > 
> > # Diego E. Pettenò<flameeyes@gentoo.org>  (10 Aug 2010)
> > #  on behalf of QA team
> > #
> > # Breaks about any QA policy regarding not touching
> > # live filesystem as it writes to LVM configuration,
> > # cron configuration, current-running kernel modules, RPM
> > # library, ...
> > #
> > # Removal on 2010-10-09
> > app-admin/webmin
> > 
> > That help?
> 
> Yes, thank you.  :)

Note that you can find this information in /usr/portage/profile/package.mask.

HTH
-- 
Marc Joliet

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-user] Ebuild hacking howto

[Mark Shields]

[-- Attachment #1: Type: text/plain, Size: 919 bytes --]

On Sat, Feb 26, 2011 at 9:56 AM, Dale <rdalek1967@gmail.com> wrote:

> Mick wrote:
>
>>
>> Not related to the OP's question, but couldn't stop myself from asking:
>>
>> Why is/was webmin dropped from portage?
>>
>> I saw bug 348432 for webmin-1.530, but other than offering an ebuild it
>> didn't
>> say.
>>
>>
>
> From gentoo-dev:
>
> # Diego E. Pettenņ<flameeyes@gentoo.org>  (10 Aug 2010)
> #  on behalf of QA team
> #
> # Breaks about any QA policy regarding not touching
> # live filesystem as it writes to LVM configuration,
> # cron configuration, current-running kernel modules, RPM
> # library, ...
> #
> # Removal on 2010-10-09
> app-admin/webmin
>
> That help?
>
> Dale
>
> :-)  :-)
>
>
Not going to beat a dead horse, but that is exactly one of the things it's
supposed to do.  The program itself works great, it just doesn't meet the
requirements of the Gentoo devs.

[-- Attachment #2: Type: text/html, Size: 1464 bytes --]

Re: [gentoo-user] Ebuild hacking howto

[Mike Gilbert]

On Sun, Feb 27, 2011 at 8:43 PM, Mark Shields <laebshade@gmail.com> wrote:
> On Sat, Feb 26, 2011 at 9:56 AM, Dale <rdalek1967@gmail.com> wrote:
>>
>> Mick wrote:
>>>
>>> Not related to the OP's question, but couldn't stop myself from asking:
>>>
>>> Why is/was webmin dropped from portage?
>>>
>>> I saw bug 348432 for webmin-1.530, but other than offering an ebuild it
>>> didn't
>>> say.
>>>
>>
>> From gentoo-dev:
>>
>> # Diego E. Pettenņ<flameeyes@gentoo.org>  (10 Aug 2010)
>> #  on behalf of QA team
>> #
>> # Breaks about any QA policy regarding not touching
>> # live filesystem as it writes to LVM configuration,
>> # cron configuration, current-running kernel modules, RPM
>> # library, ...
>> #
>> # Removal on 2010-10-09
>> app-admin/webmin
>>
>> That help?
>>
>> Dale
>>
>> :-)  :-)
>>
>
> Not going to beat a dead horse, but that is exactly one of the things it's
> supposed to do.  The program itself works great, it just doesn't meet the
> requirements of the Gentoo devs.

Diego didn't mask it because webmin itself modified config files; of
course that is what it is supposed to do. Rather, it was masked
because the ebuild itself was dodging the sandbox protection.

See Diego's blog for more info:

http://blog.flameeyes.eu/2010/08/20/there-s-something-about-webmin

[gentoo-user] Re: Ebuild hacking howto

[James]

Mark Shields <laebshade <at> gmail.com> writes:


> Saw that you linked to the "creating an updated ebuild" from gentoo-wiki, so
what I say may overlay quite a bit, but hear me out:

> Attachment (jffnms-0.8.5.ebuild): application/octet-stream, 2207 bytes


Mark,
I appreciate your answer very much. I'm looking at this now as we speak.
I'll follow up tomorrow on the results of my efforts, using your
suggestions.


thanks very much,

James