Author: Michael Lucas

For those who are watching me write the third edition of “Absolute FreeBSD,” here’s where things stand.

It’s at 77,400 words. 7 of 24 chapters exist [edit: oops, typo, not “chapter sexist,” spellcheckers are useless] as first drafts. Three more chapters are partially finished.

The current outline looks like this. Chapter titles subject to change. For reference, the ideal chapter length of a No Starch book is about 5000 words.

0 – Introduction (7500 words, d1 done)
1 – Getting More Help
2 – Pre-Install Considerations (4900 words)
3 – Installing (write last, because screenshots are evil)
4 – Booting (8300 words, SOL hates me)
5 – Backups
6 – Kernel
7 – Networking (8800 words, d1 done)
8 – Configuring Ethernet (7700 words, d1 done)
9 – Security
10 – Partitioning & GEOM (10700 words, d1 done)
11 – UFS (8000 words)
12 – ZFS
13 – Other Filesystems
14 – More Security
15 – /etc
16 – Packages (8600 words, d1 done)
17 – Ports (6800 words, d1 done)
18 – Software Management
19 – Upgrading
20 – Small System Services
21 – Performance
22 – Jails (6100 words, d1 done)
23 – Misc Crap
24 – Panics & Bugs
Afterword

Why write in this order?

When writing a large book, I always write the hard parts first. This means the book gets easier as it goes on. I don’t waste time or energy dreading That Topic.

It also means that I can write the really easy stuff when I literally cannot write the difficult stuff. I went to London, Ontario last weekend and was able to spend a few hours writing. I didn’t have my test lab, but I could sit on the front porch and write the Introduction.

Some of these chapters are difficult because of the research and testing. IPMI Serial over LAN is really ticking me off right now. I’m sure there’s a minor setting that I’m missing, and that once I find it everything will fall into place. Finding that setting will tell me what I don’t know, and let me explain and provide context. People buy my books for context. So, the product here is my frustration and suffering.

Some of these chapters are difficult because I’ve done too much research. I get a chapter on ZFS? Cool. But Allan Jude and I wrote two entire books on ZFS. Distilling that down to one-sixteenth the length, while providing context, and not shamelessly shilling those two books? Ugh.

Why these topics?

Because that’s what FreeBSD sysadmins must know.

Some of you will ask “where is bhyve?” Fair question. The bhyve developers are actively rototilling bhyve configuration. If I write a bhyve chapter now, it will be obsolete before the book hits print. That’s bad Including a bhyve chapter depends entirely on the bhyve devs.

If the bhyve devs settle on a configuration before the end of October, I’ll squeeze a chapter in after the jails chapter.

If they don’t, then you’ll have to wait for FreeBSD Mastery: Bhyve.

I’d like to have the third edition of Absolute FreeBSD in print by May 2018, for BSDCan. After discussions with No Starch Press, to make that happen I must complete the first draft before November 2017.

That’s four months.

To complicate things further, in those four months I have four weeks of traveling: BSDCam, EuroBSDCon, and a writing business workshop.

So, three months.

My best guess is that I have to write about 15,000 words a week to make that happen. Call it 3,000 words a working day. At my nonfiction cruising speed of 500 words an hour, that’s roughly 30 hours a week, or six hours a day. Provided nothing goes wrong.

I can only maintain that nonfiction speed if I write fiction as well. Without it, my nonfiction speed drops to about 200 words/hour. So I’ll keep doing 90 minutes a day on “Terrapin Sky Tango,” the sequel to Butterfly Waltz Stomp.

That’s 7.5 hours a day.

Plus I have a business to run. I have to assemble the “Core Concepts of ZFS” tutorial for EuroBSDCon. (If you’re in Europe and want to see me, this is your chance until some time in the 2020s.) I need to spend 2-3 nights a week on my martial arts practice.

The upshot is, you won’t see me around much until November.

The good news is, I’ve done the hardest parts of AF3e first. And I’ll squeeze in some time on weekends and evenings to get ahead.

But for now: book!

I finally have my grubby mitts on a print copy of Relayd and Httpd Mastery.

The cover is nice, but the inside has a couple problems. Specifically the TLS chapter.

I wrote this book on -current. Shortly after I finished writing about TLS, though, the -b flag for automatic backup was removed.

Someone pointed this out to me before I went to print. In my daftness, though, I misunderstood. (“Yes, yes, I know about the -b flag, what’s the problem?”)

There’s also a couple of other minor things–they changed acme-client -N to -D, and I missed one in an example. A couple sentences no verb.

These are embarrassing, but not critical if you know about them. The total error is about a third of a page, which isn’t bad for a 235-page book.

I’ve corrected the book. All ebook vendors have updated versions as of yesterday morning. Print versions ordered now should also be correct.

That leaves me responsible for three problems, though.

First, there’s no way I can have corrected print versions before BSDCan. It’s just not physically possible. So the copies I’ll have at BSDCan will have the error.

Second, 18 people ordered the print copy before I caught the error. Those 18 people are clearly both hard-core OpenBSD fans, and my hard-core fans. They are the people it’s most important I keep happy. It’s fully understandable that you’d want a correct book. If you desire a corrected print version, contact me. I’ll send you my mailing address. Mail me your incorrect book, and I’ll send you a correct one.

Yes, I’ll lose money on that exchange. Yes, I’m hoping most of you will decide to keep your “Special January 2017 OpenBSD-current Collectors Edition of Relayd and Httpd Mastery.” Yes, I’m hoping possession of that print book will turn into something that gives you hard-core bragging rights.

But you 18 folks? The ones who rushed out to get the book immediately upon release? You’re the ones I must keep happy.

So: the exchange is yours upon request.

If you’re one of those folks, do NOT return the book to Amazon! The Big A will put the incorrect copy on the shelf and ship it to someone else.

Third? Sponsors. Sponsors will get a copy of the good version. This means I must ship them after BSDCan.

Did this happen because I’m self-published? Nope. I submit the first sentence of Absolute OpenBSD as a counter-example.

Most of the time I don’t worry much about errata. I fix urgent daftness and move on. This one is particularly egregious and notably embarrassing, though–especially as it was pointed out to me before release.

The top of page 86 now reads:

find it easiest to create the backup file when create or renew a certificate. Back up the cert.pem, chain.pem, and fullchain.pem files. As I name each certificate file after the site, I can put all the backups in a location like /etc/ssl/acme/backups. Your update shell script needs something like this after a renewal.

DATE=$(date +%Y-%m-%d-%H:%M:%S)
cp /etc/ssl/acme/www3/www3.crt /etc/ssl/acme/backup/www3.crt.$DATE
cp /etc/ssl/acme/www3/www3.chain.pem /etc/ssl/acme/backup/www3.chain.pem.$DATE
cp /etc/ssl/acme/www3/www3.fullchain.pem /etc/ssl/acme/backup/www3.fullchain.pem.$DATE

Yes, anyone who bought the book could script better in their sleep. But the screwup is my fault and my responsibility.