Supplemental Linux® From Scratch (System V Edition) - Version #62ee

Chapter 6. Programming

samurai-737f70

Introduction to samurai

The samurai package provides a drop-in replacement for the Ninja package. It aims for full compatibility.

Installation of samurai

Install samurai by running the following commands: 

make CC=cc CFLAGS+=" -std=c99"

Now, as the root user: 

make PREFIX=/usr install

Configuring samurai

Configuration Information

If you want samu to be used whenever ninja is run, move the original Ninja out of the way and make a symlink as the root user: 

mv /usr/bin/ninja{,.old} &&
ln -svf samu /usr/bin/ninja

samu won't run on all logical CPUs or threads by default, similar to make. The process to make it do so is the same: pass -j<x>, where <x> is the number of logical CPUs you want to use whenever samu (or ninja if you made the symlink) is run. You can get around having to specify it every time by including -j<x> in SAMUFLAGS like so: 

export SAMUFLAGS=-j$(nproc)

If MAKEFLAGS only contains the -j option, you can set SAMUFLAGS to MAKEFLAGS like so: 

export SAMUFLAGS=$MAKEFLAGS

If you'd like to avoid manually setting SAMUFLAGS each time you log in, add it to a Bash profile script like ~/.bash_profile.

Contents

Installed Programs: samu
Installed Libraries: None
Installed Directories: None

Short Descriptions

samu

is a drop-in replacement for ninja