d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document the existence of the cloudabi32 kernel module.

Browse Source
This commit is contained in:
Ed Schouten 2016-08-24 12:53:54 +00:00
parent affba8c71c
commit 7c5f97dfcd
1 changed files with 29 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
share/man/man4/cloudabi.4
View File

@ -1,4 +1,4 @@
.\" Copyright (c) 2015 Nuxi, https://nuxi.nl/ .\" Copyright (c) 2015-2016 Nuxi, https://nuxi.nl/
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions .\" modification, are permitted provided that the following conditions
@ -22,17 +22,25 @@
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.Dd October 22, 2015 .Dd August 24, 2016
.Dt CLOUDABI 4 .Dt CLOUDABI 4
.Os .Os
.Sh NAME .Sh NAME
.Nm cloudabi , .Nm cloudabi ,
.Nm cloudabi32 ,
.Nm cloudabi64 .Nm cloudabi64
.Nd CloudABI support .Nd CloudABI support
.Sh SYNOPSIS .Sh SYNOPSIS
Support for 64-bit CloudABI executables can be compiled into the kernel Support for 32-bit CloudABI executables can be compiled into the kernel
by adding this line to the kernel configuration file: by adding this line to the kernel configuration file:
.Bd -ragged -offset indent .Bd -ragged -offset indent
.Cd "options COMPAT_CLOUDABI32"
.Ed
.Pp
Similarly,
support for 64-bit CloudABI executables can be enabled by adding this
line:
.Bd -ragged -offset indent
.Cd "options COMPAT_CLOUDABI64" .Cd "options COMPAT_CLOUDABI64"
.Ed .Ed
.Pp .Pp
@ -40,6 +48,7 @@ CloudABI support can also be loaded at boot time from
.Xr loader.conf 5 : .Xr loader.conf 5 :
.Bd -literal -offset indent .Bd -literal -offset indent
cloudabi_load="YES" cloudabi_load="YES"
cloudabi32_load="YES"
cloudabi64_load="YES" cloudabi64_load="YES"
.Ed .Ed
.Sh DESCRIPTION .Sh DESCRIPTION
@ -52,19 +61,21 @@ and hardened against security exploits.
.Pp .Pp
Support for CloudABI on Support for CloudABI on
.Fx .Fx
consists of two separate kernel modules. consists of three separate kernel modules.
The The
.Nm cloudabi .Nm cloudabi
kernel module implements all of the system calls that do not depend on kernel module implements all of the system calls that do not depend on
data structures that differ between architectures. data structures that differ between hardware architectures.
.Pp .Pp
The The
.Nm cloudabi32
and
.Nm cloudabi64 .Nm cloudabi64
kernel module provides implementations of all of the machine-dependent kernel modules provide implementations of all of the machine-dependent
system calls. system calls,
It assumes that pointers stored in data structures provided as system assuming that pointers stored in data structures are either 32 bits or
call arguments are 64 bits in size. 64 bits in size.
It also provides the image activator that loads and starts 64-bit ELF These modules also provide the image activators that load and start ELF
executables. executables.
.Pp .Pp
Though the Though the
@ -72,8 +83,12 @@ Though the
module can be loaded on any architecture supported by module can be loaded on any architecture supported by
.Fx , .Fx ,
the the
.Nm cloudabi32
module is only available on i386 and amd64.
The same holds for the
.Nm cloudabi64 .Nm cloudabi64
module is only available for amd64 and arm64. module,
which is only available for amd64 and arm64.
.Pp .Pp
A full cross compilation toolchain for CloudABI is available in the A full cross compilation toolchain for CloudABI is available in the
.Pa devel/cloudabi-toolchain .Pa devel/cloudabi-toolchain
@ -93,6 +108,9 @@ restricted set of resources.
.Xr linux 4 , .Xr linux 4 ,
.Xr elf 5 .Xr elf 5
.Pp .Pp
CloudABI for FreeBSD:
.Pa https://nuxi.nl/cloudabi/freebsd/ .
.Pp
cloudlibc on GitHub: cloudlibc on GitHub:
.Pa https://github.com/NuxiNL/cloudlibc . .Pa https://github.com/NuxiNL/cloudlibc .
.Pp .Pp