ENV

Ahmad Fatoum a.fatoum at pengutronix.de
Mon May 18 01:53:26 PDT 2026


Hello Mark,

On 5/14/26 11:53 PM, Mark Diener wrote:
> Is there better resources to detail how to properly understand the
> details behind /env/  (its creation and components)?

What are you missing in the official documentation?

> I cannot get the barebox.efi to actually execute the /env/bin/init script.

Scripts in /env/bin are added to PATH, so you can execute them by just
their name (instead of their full path), but they are not automatically
executed.

If you want a script to be executed automatically at init time, add it
into /env/init/.

> bareboxenv seems like a utility that would be involved.

If you want to modify the script from Linux, yes. bareboxenv is also
used by barebox itself during the build process and can be used to bake
a built-in environment into barebox.

That's the preferred way of shipping the default environment.

What do you want to do in your init script?

> Also, when I bootm my bzImage, it hangs up and seems to lose track of
> mounting the storage so it just stops processing.

Hanging as in seeing a

  Kernel panic - not syncing: Attempted to kill init

?

If so, you must have barebox add a root= option to inform the kernel
where it can find its rootfs.

You can try it out manually using:

global linux.bootargs.myroot="root=<insert your root device or PARTUUID,
..etc. here>"

> My barebox.efi is launching, but tripping on properly have the
> /env/bin/init directory established

/env/bin/init is an optional init script you can provide. I just Cc'd
you on changes to the docs that make this clearer.

Putting your init scripts in /env/init/ is what you are likely after.

Cheers,
Ahmad

> 
> Any comments appreciated,
> 
> Marco
> 
> 

-- 
Pengutronix e.K.                  |                             |
Steuerwalder Str. 21              | http://www.pengutronix.de/  |
31137 Hildesheim, Germany         | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686  | Fax:   +49-5121-206917-5555 |




More information about the barebox mailing list