Adventures in tinderbox 2

If you stumbled into this post first you may want to have a look over this previous post as we are building upon steps covered there.

So far we have got our world binaries built and these are the foundation of the environments we setup for testing our port builds. From here we create a tinderbox build. Within tinderbox a build refers to a combination of world binaries (the tinderbox jails we setup before) and a version of the ports files. It is probably a rare case but it would appear that you could setup a build using say netbsd pkgsrc system or similar, the most likely alternative to the official ports system would be an internal development branch of the ports source.

The first step is to setup the ports files to be used. A cvs checkout is shown in the docs and you could adjust the svn usage from yesterday if you have your own local svn repo (official ports are still in cvs at this point). The examples in the docs show a source checkout that is unique to your tinderbox setup. I think using the system installed ports will be enough for what I want and will bypass the confusion of three copies of the ports files. Personally I use portsnap to update my system ports tree and create or update a port there to test and develop it. Then I have a copy within my home folder that is an svn checkout from my redports account that I transfer changes to that I want to keep, and commit as desired from there. While my personal folder is just the ports I make changes to, I don't want a third copy just for test builds, so what I will use here is a user defined update method that will run portsnap anytime I want to update the ports tree. We have two options here, 1. create a portsTree with no update method leaving us to run portsnap manually as desired. 2. create a portsTree with a user update method. The first option is straight forward and acceptable for most but I want to look at option 2 here.

Reading the docs you may jump straight in and use a command like cd /usr/local/tinderbox/scripts ./tc createPortsTree -p FreeBSD -u USER -m /usr/ports and get errors and no ports tree setup. The docs don't help here so I went digging through the scripts and found the answer. When you create a portstree with a user defined update method it looks for the update script when it is first setup. The solution is simple. If we are creating a portstree called FreeBSD then we create a file in tinderbox/portstrees/FreeBSD and call it and for this example I want it to run portsnap so I use the following contents - #!/bin/sh portsnap fetch update Then run the createPortsTree command with the -u USER option. Simple and a good basis of any custom update you want to setup. You could even use this to run portsnap and then merge files from your personal ports repo automatically. This setup script is run with the command ./tc updatePortsTree

You may also want to share your local distfiles with tinderbox. Pretty easy and the one setup is shared across all portstree configs -

cd /usr/local/tinderbox/scripts ./tc configDistfile -c /usr/ports/distfiles

Now that we have our jails and portsTree setup it is time for the build. Remember a tinderbox build is a combination of a specific jail and portsTree and is straight forward -

cd /usr/local/tinderbox/scripts ./tc createBuild -b 10-CURRENT-clang -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with clang"

The name I used there may raise a few questions but first lets consider what variations of builds we want to use.

The aim of using tinderbox is to test building under a variety of conditions, in this case primarily different system versions. To that end we started by creating 2 jails with different versions of world binaries, you may have extended that number and I encourage you to do so but I use two in these examples. From FreeBSD 9.0 we are moving away from a  dependency on gcc as the main compiler and now include clang within the base system. Being in the early transition of this is a bit awkward as not all ports build with the old gcc v4.2 that is included with base and not all ports build with clang either. Well ports changes need to be tested with each compiler so we may get a full ports build happening on any system install. One option we have is to specify what version of gcc is used to build our port. Easy till we get linking issues with something like boost installed with gcc42 and not linking with a gcc46 built port (that is my early guess and may not be the location of a solution). So anyway I am suggesting that a number of builds are setup to test building with clang as well as gcc. This will only apply to 9.0 and higher, 8.3 has just entered beta1 and doesn't appear to include clang. The other question you may have is that I only put clang in the name, how does it know to build with clang? It doesn't yet - that comes in a minute.

Well using the two jails we built yesterday lets setup the builds -

cd /usr/local/tinderbox/scripts ./tc createBuild -b 10-CURRENT-clang -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with clang" ./tc createBuild -b 10-CURRENT-gcc -j 10-CURRENT -p FreeBSD -d "10-CURRENT building with gcc" ./tc createBuild -b 9-STABLE-clang -j 9-STABLE -p FreeBSD -d "9-STABLE building with clang" ./tc createBuild -b 9-STABLE-gcc -j 9-STABLE -p FreeBSD -d "9-STABLE building with gcc"

Now we have four builds setup to test our ports in. As I suggested before you should also consider having at least an 8-STABLE jail setup and maybe even a 7-STABLE one as well if not more. As clang is not included in 7 or 8 there is no need to setup two builds for each, I would still use gcc in the build name though.

At this point you will find a few directories have been created. The first you will probably see is tinderbox/{BUILDNAME} so if your following along you will have four there corresponding to each build you setup. The next ones are inside tinderbox/builds and have the same names as the four we just looked at. The dirs inside builds contain a Makefile with all the package  dependencies and although you may think make.0 and make.1 are makefiles they are in fact logs containing the log of the last compile done, each port compile is run in two phases, and a more than likely empty duds file. The top level dirs are where all the work is done. For each port you make, tinderbox will extract the tarball found in the corresponding jail build and mount the various points needed for portstrees/distfiles/devfs/procfs. From that you can work out that each build starts up in a unique environment (it uses chroot) completely isolated for your test make. Each environment is cleaned up after each test make and the log files will include files left behind if you get your pkg-plist incorrect.

Now to configuring the compiler to use. When you first test making your port and look at a log file you may notice that the timestamp at the start is all wrong. That will be a wrong timezone setting and gets us close to the compiler settings. First lets set the timezone, so edit the file tinderbox/scripts/etc/env/GLOBAL and add the following line (adjusted to match your timezone of course)

export TZ=Australia/Adelaide

You can see that it uses a bash style environment setting. Within the same folder we want to create a config file for each build we setup using the name build.{BUILDNAME} and have it contain the CC options that we wish to use. Before you go thinking about copying all your /etc/make.conf settings consider the purpose of this - testing against a minimum system config to ensure your port is as compatible as possible. Those with a custom edited make.conf need to handle their own port build conflicts with the options they want to use. So here all we want to do is set the compiler to use. To make this easy let's make a script, I will put this inside tinderbox/scripts and lets call it

#!/bin/sh cd /usr/local/tinderbox/scripts/etc/env for BNAME in `ls ../../../builds | grep clang` do if [ ! -e build.$BNAME ] then cat > build.$BNAME <<CCOPTIONS export CC=clang export CXX=clang++ export CPP=clang-cpp CCOPTIONS fi done for BNAME in `ls ../../../builds | grep gcc` do if [ ! -e build.$BNAME ] then cat > build.$BNAME <<CCOPTIONS export CC=gcc export CXX=g++ export CPP=cpp CCOPTIONS fi done

Pretty straight forward if you know some shell scripting, if it's a bit beyond what you know it simply gets a list of dirs from within builds and outputs three lines to a corresponding config file for each one. The script won't touch files that already exist, so delete them if you want a clean slate or adjust if you want to add to existing files. The first loop uses grep to get clang named builds the second gcc. Is it overkill specifying gcc for the gcc builds - yep - but it keeps things consistent and also gets the CC setting output to the log file to remove any confusion when looking over them later, or more to the point when you get someone else to look over them for some help.

Now your all setup to use tinderbox to test your ports building. While the docs say you can do an adhoc build with just the tinderbuild command I find that not to be the case, the two command you use are

cd /usr/local/tinderbox/scripts ./tc addPort -b 10-CURRENT-clang -d graphics/blender ./tc tinderbuild -nullfs -b 10-CURRENT-clang graphics/blender

The first time you build a port it may take a while - it will build each  dependency needed, basically running make package-recursive for your port. Next time it will just pkg_add each dependancy and build the port you ask it to. The -nullfs option is needed if you setup the nullfs mount for portstree as shown above (or maybe it is for distfiles?). This adds some more dirs for you as well.

tinderbox/packages/{BUILDNAME} will contain all the packages created by that build. You will find a folder for each category containing links to the corresponding package inside the All dir.

tinderbox/logs/{BUILDNAME} will contain log files of each port compiled for that build.

tinderbox/errors/{BUILDNAME} will contain copies of the log files that had errors - this is probably all your really interested in.

That's about all you need to get up and running with tinderbox. I think I will do one more post covering some housekeeping and other notes. To close off I'll show a script I use to automate running any number of ports inside every build you have configured, I save it in tinderbox/scripts and call it

#!/bin/sh ## auto build passed ports for every tinderbox build setup ## works on assumption that /usr/ports is used for tinderbox portstree ## to test that the portname is correct cd /usr/local/tinderbox/scripts if [ ! $# -gt 0 ] then echo "Usage: ${0##*/} [category/portname ...]" echo "Multiple ports can be listed - space separated list" exit 1 fi for TESTPORT in "$@" do if [ ! -e "/usr/ports/$TESTPORT" ] then echo "********************" echo " /usr/ports/$TESTPORT doesn't exist" echo "********************" else for BNAME in `ls ../builds` do echo "***** Building $TESTPORT" ./tc addPort -b $BNAME -d ${TESTPORT} ./tc tinderbuild -nullfs -b $BNAME ${TESTPORT} done fi done

So to make use of the script

cd /usr/local/tinderbox/scripts ./ graphics/blender graphics/luxrender ports-mgmt/tinderbox

and it will go through and compile each port with every tinderbox build you have setup.


dự án đông tăng long's picture

Excellent goods from you, man. I've understand your stuff previous to and you are just extremely wonderful.
I actually like what you have acquired here, certainly like what you're stating and the way in which
you say it. You make it enjoyable and you still care for to keep it
smart. I can't wait to read far more from you.
This is really a tremendous site.

ห้องจัดเลี้ยง's picture

I like what you guys tend to be up too. This kind of clever work and reporting!
Keep up the wonderful works guys I've added you guys to my personal blogroll.

ให้เช่าเต๊นท์'s picture

Informative article, exactly what I was looking for.

splitters for iphone's picture

For the reason that the admin of this website is working, no doubt very shortly it will be well-known, due to its
feature contents.

allah bible's picture

I do not know whether it's just me or if perhaps everybody else
experiencing issues with your site. It appears as if some of
the written text in your posts are running off the screen. Can somebody else please
provide feedback and let me know if this
is happening to them too? This may be a issue with my web browser because I've had this happen before.
Appreciate it

click here to investigate's picture

Excellent blog here! Additionally your website loads up fast!
What web host are you using? Can I am getting your affiliate hyperlink to your host?
I want my site loaded up as fast as yours lol

horny flava's picture

I every time spent my half an hour to read this website's content everyday along with a cup of coffee.

Domino Online's picture

Link exchange is nothing else except it is only placing the
other person's weblog link on your page at appropriate place and other person will also do same in support of you.

Matthias's picture

Hello to all, the contents existing at this web page are actually amazing for people
experience, well, keep up the good work fellows.

basement flooding's picture

Hi there, There's no doubt that your blog might be having internet browser compatibility
issues. When I look at your web site in Safari, it looks fine however when opening
in Internet Explorer, it's got some overlapping issues.
I simply wanted to provide you with a quick heads up!

Apart from that, excellent site!

date kraine girls's picture

It's really very complex in this busy life to listen news on TV, therefore
I only use the web for that reason, and get the most recent news.

90 day fiance Ukraine's picture

I think that is one of the so much important information for me.
And i'm happy reading your article. However want to
statement on few general issues, The site style is wonderful, the articles is in point of fact
great : D. Just right process, cheers

loft conversion specialists's picture

Hi there! This post couldn't be written any better!
Reading through this post reminds me of my good
old room mate! He always kept chatting about this.
I will forward this post to him. Pretty sure he will have a
good read. Thanks for sharing!

bandar sakong's picture

It's a pity you don't have a donate button! I'd most certainly donate to this outstanding blog!
I guess for now i'll settle for bookmarking and adding your RSS feed to my Google account.
I look forward to brand new updates and will share this website with my Facebook group.
Chat soon!

sakong online's picture

What's up to all, it's genuinely a fastidious for me to pay a visit
this site, it consists of priceless Information.

This website talking about Clickreviewz's picture

Nice post. I was checking constantly this blog and I am impressed!

Extremely helpful info specifically the final part :
) I handle such information much. I was looking for this certain information for
a very lengthy time. Thank you and good luck.

bitcoin crowdfunding's picture

It's remarkable to pay a visit this web site and reading the views of all colleagues regarding this
paragraph, while I am also keen of getting familiarity.

คาสิโนออนไลน์ เครดิตฟรี's picture

Quality content is the main to be a focus for the people
to pay a quick visit the website, that's what this web site is providing.

distressed property's picture

Great weblog here! Additionally your site a lot up very fast!
What web host are you the use of? Can I am getting your affiliate
hyperlink in your host? I wish my web site loaded up as quickly as yours lol

Togel Hongkong's picture

You need to be a part of a contest for one of the greatest blogs on the web.
I will recommend this blog!

إزالة الشعر's picture

This article will help the internet visitors for creating new blog or even a weblog from start to end.

apocalypses rpg's picture

Aw, this was an incredibly good post. Spending some time and actual effort to make a very good article... but what can I
say... I hesitate a lot and don't seem to get nearly anything done.

online video cutter's picture

You actually make it seem so easy with your presentation but I find this matter to be really
something which I think I would never understand. It seems too complicated and extremely broad for me.

I'm looking forward for your next post, I will
try to get the hang of it!

dirt rally free's picture

Wow, amazing blog format! How lengthy have you been blogging for?

you make blogging look easy. The entire glance of your website is magnificent, as well as the content

rome total war collection steam key's picture

You really make it appear so easy with your presentation but I in finding this matter to be really one thing
that I believe I'd by no means understand. It seems too complex and very vast for me.
I am having a look ahead in your subsequent publish, I will attempt to get the dangle of it!

five nights at freddys 3 free's picture

Right here is the perfect web site for anybody who wishes to
understand this topic. You understand so much its almost tough to
argue with you (not that I actually would want to...HaHa).
You definitely put a brand new spin on a topic that's been written about for many years.
Excellent stuff, just wonderful!

dead realm free's picture

I got this web site from my buddy who told me regarding this web page and at the moment this time
I am browsing this website and reading very informative content here.

Kitchen Remodeling St. Louis's picture

Have real looking expectations.

baldurs gate ii enhanced edition steam key's picture

Hello would you mind letting me know which hosting company you're
utilizing? I've loaded your blog in 3 different browsers and I must say
this blog loads a lot quicker then most. Can you
suggest a good web hosting provider at a reasonable price?

Thanks, I appreciate it!

cheap socials's picture

First of all I want to say excellent blog! I had a quick question in which I'd like to ask if you
don't mind. I was curious to find out how you center yourself and clear your head prior to writing.
I've had a hard time clearing my mind in getting my thoughts
out. I truly do take pleasure in writing but it just seems like the
first 10 to 15 minutes are generally wasted just
trying to figure out how to begin. Any ideas or hints?


highschool romance free's picture

I have read so many content concerning the blogger lovers but
this piece of writing is really a nice article, keep it up.

act of aggression free steam key's picture

Hi there, after reading this amazing post
i am too cheerful to share my familiarity here with mates.'s picture

Perhaps flipping a house isn't your thing, Maybe you are
simply looking at foreclosures to search out a superb
home with fast equity.

Velda's picture

Dentists give oral health services to adults and
children. Some dentists select to study a subspecialty, such
as orthodontics.

duck game steam's picture

I hardly comment, however after reading through some of the remarks on Add new comment |
I do have a couple of questions for you if it's allright.
Is it simply me or do a few of these responses appear like they are coming from brain dead folks?

:-P And, if you are writing on other social sites, I would like to keep
up with anything fresh you have to post. Could you post a list of every
one of your social pages like your linkedin profile, Facebook
page or twitter feed?

Road To Survival Online Hack's picture

Appreciate the recommendation. Will try it out.

Hermelinda's picture

There are four i - Pod lines: The i - Pod Classic
hard-disk player, the Nano flash players, and the Touch flash players with a large touch screen,
full Web browser, and the ability to download content wirelessly over its Wi-Fi connection. 1) the first tip
is to scout for the kit online, where you would have a variety of different repair kit choices to pick and
select from. Or maybe not, you techno Dr.'s picture

Unquestionably believe that which you said. Your favorite
justification seemed to be on the internet the easiest thing to be aware of.
I say to you, I certainly get annoyed while
people think about worries that they plainly don't know about.

You managed to hit the nail upon the top and defined
out the whole thing without having side-effects , people could take a signal.
Will likely be back to get more. Thanks

Stop by my web blog ... cambridge web designers -,

Budget-Friendly Cross-Country Move Suggestions's picture

Hey there, You've done a great job. I will certainly digg it and
personally recommend to my friends. I am confident they'll
be benefited from this web site.

Stop by my homepage Budget-Friendly Cross-Country Move Suggestions

brake pads's picture

I just like the helpful information you supply on your articles.
I'll bookmark your weblog and test once more here frequently.
I'm fairly sure I'll learn many new stuff proper right here!

Good luck for the following!

My web page :: brake pads

Service Design's picture

Does your website have a contact page? I'm having
a tough time locating it but, I'd like to send you
an e-mail. I've got some creative ideas for your blog you might be interested in hearing.
Either way, great blog and I look forward to seeing it expand over time.

Here is my homepage: Service Design

Mozambique attractions's picture

Simply want to say your article is as astounding.
The clarity to your publish is simply spectacular and i can suppose
you are knowledgeable in this subject. Well together
with your permission let me to take hold of your feed to keep up to date with coming
near near post. Thanks one million and please continue the gratifying work.

Feel free to visit my website :: Mozambique attractions

Deandre's picture

Hi to every single one, it's actually a good for me to
pay a quick visit this site, it consists of precious Information.

Also visit my blog; Get Free PlayStation Gift Code Generator (Deandre)

black jack 21's picture

Hi there, I found your website via Google whilst searching for a
comparable subject, your site came up, it seems
good. I've bookmarked it in my google bookmarks.
Hi there, simply become aware of your blog via Google, and found that it's really
informative. I'm going to be careful for brussels. I'll be grateful when you continue
this in future. Many people might be benefited out of your writing.

My blog post - black jack 21

blackjack online's picture

We are a gaggle of volunteers and opening a new scheme in our
community. Your web site provided us with helpful information to work on. You've performed an impressive job
and our whole neighborhood might be grateful to you.

my weblog blackjack online

موعد مباراة's picture

you're really a excellent webmaster. The website loading pace is amazing.
It sort of feels that you are doing any distinctive trick.
In addition, The contents are masterwork. you have performed a fantastic activity on this matter!

Check out my web page; mw`d mbr@

floor lamps for living room's picture

Thanks on your marvelous posting! I quite enjoyed reading
it, you can be a great author. I will be sure to bookmark your
blog and will come back sometime soon. I want to encourage you to continue
your great posts, have a nice weekend!

Christian Nurses's picture

Definitely believe that that you stated. Your favourite justification appeared to
be at the web the easiest thing to take into accout of. I say to you,
I certainly get irked whilst other people think about worries that they plainly do not realize about.
You managed to hit the nail upon the top and defined out the entire thing with no need side-effects ,
other folks can take a signal. Will probably be back to get more.

Consignment's picture

You should be a part of a contest for one
of the finest sites on the net. I will recommend this website!

W88th's picture

Hi I am so delighted I found your blog, I really found
you by accident, while I was researching on Google for something else, Regardless I am here now and would
just like to say kudos for a tremendous post and a all round entertaining blog (I also love the theme/design),
I don't have time to look over it all at the minute but I have book-marked
it and also added your RSS feeds, so when I have time I will
be back to read more, Please do keep up the great work.


Add new comment