...

Text file src/syscall/mkall.sh

Documentation: syscall

     1#!/usr/bin/env bash
     2# Copyright 2009 The Go Authors. All rights reserved.
     3# Use of this source code is governed by a BSD-style
     4# license that can be found in the LICENSE file.
     5
     6# The syscall package provides access to the raw system call
     7# interface of the underlying operating system.  Porting Go to
     8# a new architecture/operating system combination requires
     9# some manual effort, though there are tools that automate
    10# much of the process.  The auto-generated files have names
    11# beginning with z.
    12#
    13# This script runs or (given -n) prints suggested commands to generate z files
    14# for the current system.  Running those commands is not automatic.
    15# This script is documentation more than anything else.
    16#
    17# * asm_${GOOS}_${GOARCH}.s
    18#
    19# This hand-written assembly file implements system call dispatch.
    20# There are three entry points:
    21#
    22# 	func Syscall(trap, a1, a2, a3 uintptr) (r1, r2, err uintptr);
    23# 	func Syscall6(trap, a1, a2, a3, a4, a5, a6 uintptr) (r1, r2, err uintptr);
    24# 	func RawSyscall(trap, a1, a2, a3 uintptr) (r1, r2, err uintptr);
    25#
    26# The first and second are the standard ones; they differ only in
    27# how many arguments can be passed to the kernel.
    28# The third is for low-level use by the ForkExec wrapper;
    29# unlike the first two, it does not call into the scheduler to
    30# let it know that a system call is running.
    31#
    32# * syscall_${GOOS}.go
    33#
    34# This hand-written Go file implements system calls that need
    35# special handling and lists "//sys" comments giving prototypes
    36# for ones that can be auto-generated.  Mksyscall reads those
    37# comments to generate the stubs.
    38#
    39# * syscall_${GOOS}_${GOARCH}.go
    40#
    41# Same as syscall_${GOOS}.go except that it contains code specific
    42# to ${GOOS} on one particular architecture.
    43#
    44# * types_${GOOS}.c
    45#
    46# This hand-written C file includes standard C headers and then
    47# creates typedef or enum names beginning with a dollar sign
    48# (use of $ in variable names is a gcc extension).  The hardest
    49# part about preparing this file is figuring out which headers to
    50# include and which symbols need to be #defined to get the
    51# actual data structures that pass through to the kernel system calls.
    52# Some C libraries present alternate versions for binary compatibility
    53# and translate them on the way in and out of system calls, but
    54# there is almost always a #define that can get the real ones.
    55# See types_darwin.c and types_linux.c for examples.
    56#
    57# * zerror_${GOOS}_${GOARCH}.go
    58#
    59# This machine-generated file defines the system's error numbers,
    60# error strings, and signal numbers.  The generator is "mkerrors.sh".
    61# Usually no arguments are needed, but mkerrors.sh will pass its
    62# arguments on to godefs.
    63#
    64# * zsyscall_${GOOS}_${GOARCH}.go
    65#
    66# Generated by mksyscall.pl; see syscall_${GOOS}.go above.
    67#
    68# * zsysnum_${GOOS}_${GOARCH}.go
    69#
    70# Generated by mksysnum_${GOOS}.
    71#
    72# * ztypes_${GOOS}_${GOARCH}.go
    73#
    74# Generated by godefs; see types_${GOOS}.c above.
    75
    76GOOSARCH="${GOOS}_${GOARCH}"
    77
    78# defaults
    79mksyscall="./mksyscall.pl"
    80mkerrors="./mkerrors.sh"
    81zerrors="zerrors_$GOOSARCH.go"
    82mksysctl=""
    83zsysctl="zsysctl_$GOOSARCH.go"
    84mksysnum=
    85mktypes=
    86mkasm=
    87run="sh"
    88
    89case "$1" in
    90-syscalls)
    91	for i in zsyscall*go
    92	do
    93		# Run the command line that appears in the first line
    94		# of the generated file to regenerate it.
    95		sed 1q $i | sed 's;^// ;;' | sh > _$i && gofmt < _$i > $i
    96		rm _$i
    97	done
    98	exit 0
    99	;;
   100-n)
   101	run="cat"
   102	shift
   103esac
   104
   105case "$#" in
   1060)
   107	;;
   108*)
   109	echo 'usage: mkall.sh [-n]' 1>&2
   110	exit 2
   111esac
   112
   113GOOSARCH_in=syscall_$GOOSARCH.go
   114case "$GOOSARCH" in
   115_* | *_ | _)
   116	echo 'undefined $GOOS_$GOARCH:' "$GOOSARCH" 1>&2
   117	exit 1
   118	;;
   119aix_ppc64)
   120	mkerrors="$mkerrors -maix64"
   121	mksyscall="./mksyscall_libc.pl -aix"
   122	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   123	;;
   124darwin_386)
   125	mkerrors="$mkerrors -m32"
   126	mksyscall="./mksyscall.pl -l32 -darwin"
   127	mksysnum="./mksysnum_darwin.pl /usr/include/sys/syscall.h"
   128	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   129	mkasm="go run mkasm_darwin.go"
   130	;;
   131darwin_amd64)
   132	mkerrors="$mkerrors -m64"
   133	mksyscall="./mksyscall.pl -darwin"
   134	mksysnum="./mksysnum_darwin.pl /usr/include/sys/syscall.h"
   135	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   136	mkasm="go run mkasm_darwin.go"
   137	;;
   138darwin_arm64)
   139	mkerrors="$mkerrors -m64"
   140	mksyscall="./mksyscall.pl -darwin"
   141	mksysnum="./mksysnum_darwin.pl /usr/include/sys/syscall.h"
   142	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   143	mkasm="go run mkasm_darwin.go"
   144	;;
   145darwin_arm)
   146	mkerrors="$mkerrors -m32"
   147	mksyscall="./mksyscall.pl -l32 -darwin"
   148	mksysnum="./mksysnum_darwin.pl /usr/include/sys/syscall.h"
   149	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   150	mkasm="go run mkasm_darwin.go"
   151	;;
   152dragonfly_amd64)
   153	mkerrors="$mkerrors -m64"
   154	mksyscall="./mksyscall.pl -dragonfly"
   155	mksysnum="curl -s 'http://gitweb.dragonflybsd.org/dragonfly.git/blob_plain/HEAD:/sys/kern/syscalls.master' | ./mksysnum_dragonfly.pl"
   156	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   157	;;
   158freebsd_386)
   159	mkerrors="$mkerrors -m32"
   160	mksyscall="./mksyscall.pl -l32"
   161	mksysnum="curl -s 'http://svn.freebsd.org/base/stable/10/sys/kern/syscalls.master' | ./mksysnum_freebsd.pl"
   162	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   163	;;
   164freebsd_amd64)
   165	mkerrors="$mkerrors -m64"
   166	mksysnum="curl -s 'http://svn.freebsd.org/base/stable/10/sys/kern/syscalls.master' | ./mksysnum_freebsd.pl"
   167	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   168	;;
   169freebsd_arm)
   170	mkerrors="$mkerrors"
   171	mksyscall="./mksyscall.pl -l32 -arm"
   172	mksysnum="curl -s 'http://svn.freebsd.org/base/stable/10/sys/kern/syscalls.master' | ./mksysnum_freebsd.pl"
   173	# Let the type of C char be signed to make the bare syscall
   174	# API consistent between platforms.
   175	mktypes="GOARCH=$GOARCH go tool cgo -godefs -- -fsigned-char"
   176	;;
   177linux_386)
   178	mkerrors="$mkerrors -m32"
   179	mksyscall="./mksyscall.pl -l32"
   180	mksysnum="./mksysnum_linux.pl /usr/include/asm/unistd_32.h"
   181	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   182	;;
   183linux_amd64)
   184	unistd_h=$(ls -1 /usr/include/asm/unistd_64.h /usr/include/x86_64-linux-gnu/asm/unistd_64.h 2>/dev/null | head -1)
   185	if [ "$unistd_h" = "" ]; then
   186		echo >&2 cannot find unistd_64.h
   187		exit 1
   188	fi
   189	mkerrors="$mkerrors -m64"
   190	mksysnum="./mksysnum_linux.pl $unistd_h"
   191	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   192	;;
   193linux_arm)
   194	mkerrors="$mkerrors"
   195	mksyscall="./mksyscall.pl -l32 -arm"
   196	mksysnum="curl -s 'http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/plain/arch/arm/include/uapi/asm/unistd.h' | ./mksysnum_linux.pl -"
   197	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   198	;;
   199linux_arm64)
   200	unistd_h=$(ls -1 /usr/include/asm/unistd.h /usr/include/asm-generic/unistd.h 2>/dev/null | head -1)
   201	if [ "$unistd_h" = "" ]; then
   202		echo >&2 cannot find unistd_64.h
   203		exit 1
   204	fi
   205	mksysnum="./mksysnum_linux.pl $unistd_h"
   206	# Let the type of C char be signed to make the bare syscall
   207	# API consistent between platforms.
   208	mktypes="GOARCH=$GOARCH go tool cgo -godefs -- -fsigned-char"
   209	;;
   210linux_mips)
   211	GOOSARCH_in=syscall_linux_mipsx.go
   212	unistd_h=/usr/include/asm/unistd.h
   213	mksyscall="./mksyscall.pl -b32 -arm"
   214	mkerrors="$mkerrors"
   215	mksysnum="./mksysnum_linux.pl $unistd_h"
   216	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   217	;;
   218linux_mipsle)
   219	GOOSARCH_in=syscall_linux_mipsx.go
   220	unistd_h=/usr/include/asm/unistd.h
   221	mksyscall="./mksyscall.pl -l32 -arm"
   222	mkerrors="$mkerrors"
   223	mksysnum="./mksysnum_linux.pl $unistd_h"
   224	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   225	;;
   226linux_mips64)
   227	GOOSARCH_in=syscall_linux_mips64x.go
   228	unistd_h=/usr/include/asm/unistd.h
   229	mkerrors="$mkerrors -m64"
   230	mksysnum="./mksysnum_linux.pl $unistd_h"
   231	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   232	;;
   233linux_mips64le)
   234	GOOSARCH_in=syscall_linux_mips64x.go
   235	unistd_h=/usr/include/asm/unistd.h
   236	mkerrors="$mkerrors -m64"
   237	mksysnum="./mksysnum_linux.pl $unistd_h"
   238	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   239	;;
   240linux_ppc64)
   241	GOOSARCH_in=syscall_linux_ppc64x.go
   242	unistd_h=/usr/include/asm/unistd.h
   243	mkerrors="$mkerrors -m64"
   244	mksysnum="./mksysnum_linux.pl $unistd_h"
   245	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   246	;;
   247linux_ppc64le)
   248	GOOSARCH_in=syscall_linux_ppc64x.go
   249	unistd_h=/usr/include/powerpc64le-linux-gnu/asm/unistd.h
   250	mkerrors="$mkerrors -m64"
   251	mksysnum="./mksysnum_linux.pl $unistd_h"
   252	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   253	;;
   254linux_s390x)
   255	GOOSARCH_in=syscall_linux_s390x.go
   256	unistd_h=/usr/include/asm/unistd.h
   257	mkerrors="$mkerrors -m64"
   258	mksysnum="./mksysnum_linux.pl $unistd_h"
   259	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   260	;;
   261nacl_386)
   262	mkerrors=""
   263	mksyscall="./mksyscall.pl -l32 -nacl"
   264	mksysnum=""
   265	mktypes=""
   266	;;
   267nacl_amd64p32)
   268	mkerrors=""
   269	mksyscall="./mksyscall.pl -nacl"
   270	mksysnum=""
   271	mktypes=""
   272	;;
   273netbsd_386)
   274	mkerrors="$mkerrors -m32"
   275	mksyscall="./mksyscall.pl -l32 -netbsd"
   276	mksysnum="curl -s 'http://cvsweb.netbsd.org/bsdweb.cgi/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_netbsd.pl"
   277	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   278	;;
   279netbsd_amd64)
   280	mkerrors="$mkerrors -m64"
   281	mksyscall="./mksyscall.pl -netbsd"
   282	mksysnum="curl -s 'http://cvsweb.netbsd.org/bsdweb.cgi/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_netbsd.pl"
   283	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   284	;;
   285netbsd_arm)
   286	mkerrors="$mkerrors -m32"
   287	mksyscall="./mksyscall.pl -l32 -netbsd -arm"
   288	mksysnum="curl -s 'http://cvsweb.netbsd.org/bsdweb.cgi/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_netbsd.pl"
   289	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   290	;;
   291openbsd_386)
   292	mkerrors="$mkerrors -m32"
   293	mksyscall="./mksyscall.pl -l32 -openbsd"
   294	mksysctl="./mksysctl_openbsd.pl"
   295	zsysctl="zsysctl_openbsd.go"
   296	mksysnum="curl -s 'http://cvsweb.openbsd.org/cgi-bin/cvsweb/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_openbsd.pl"
   297	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   298	;;
   299openbsd_amd64)
   300	mkerrors="$mkerrors -m64"
   301	mksyscall="./mksyscall.pl -openbsd"
   302	mksysctl="./mksysctl_openbsd.pl"
   303	zsysctl="zsysctl_openbsd.go"
   304	mksysnum="curl -s 'http://cvsweb.openbsd.org/cgi-bin/cvsweb/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_openbsd.pl"
   305	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   306	;;
   307openbsd_arm)
   308	mkerrors="$mkerrors"
   309	mksyscall="./mksyscall.pl -l32 -openbsd -arm"
   310	mksysctl="./mksysctl_openbsd.pl"
   311	zsysctl="zsysctl_openbsd.go"
   312	mksysnum="curl -s 'http://cvsweb.openbsd.org/cgi-bin/cvsweb/~checkout~/src/sys/kern/syscalls.master' | ./mksysnum_openbsd.pl"
   313	# Let the type of C char be signed to make the bare syscall
   314	# API consistent between platforms.
   315	mktypes="GOARCH=$GOARCH go tool cgo -godefs -- -fsigned-char"
   316	;;
   317plan9_386)
   318	mkerrors=
   319	mksyscall="./mksyscall.pl -l32 -plan9"
   320	mksysnum="./mksysnum_plan9.sh /n/sources/plan9/sys/src/libc/9syscall/sys.h"
   321	mktypes="XXX"
   322	;;
   323solaris_amd64)
   324	mksyscall="./mksyscall_libc.pl -solaris"
   325	mkerrors="$mkerrors -m64"
   326	mksysnum=
   327	mktypes="GOARCH=$GOARCH go tool cgo -godefs"
   328	;;
   329windows_*)
   330	echo 'run "go generate" instead' 1>&2
   331	exit 1
   332	;;
   333*)
   334	echo 'unrecognized $GOOS_$GOARCH: ' "$GOOSARCH" 1>&2
   335	exit 1
   336	;;
   337esac
   338
   339(
   340	if [ -n "$mkerrors" ]; then echo "$mkerrors |gofmt >$zerrors"; fi
   341	syscall_goos="syscall_$GOOS.go"
   342 	case "$GOOS" in
   343	darwin | dragonfly | freebsd | netbsd | openbsd)
   344		syscall_goos="syscall_bsd.go $syscall_goos"
   345 		;;
   346 	esac
   347	if [ -n "$mksyscall" ]; then echo "$mksyscall -tags $GOOS,$GOARCH $syscall_goos $GOOSARCH_in |gofmt >zsyscall_$GOOSARCH.go"; fi
   348	if [ -n "$mksysctl" ]; then echo "$mksysctl |gofmt >$zsysctl"; fi
   349	if [ -n "$mksysnum" ]; then echo "$mksysnum |gofmt >zsysnum_$GOOSARCH.go"; fi
   350	if [ -n "$mktypes" ]; then
   351		# ztypes_$GOOSARCH.go could be erased before "go run mkpost.go" is called.
   352		# Therefore, "go run" tries to recompile syscall package but ztypes is empty and it fails.
   353		echo "$mktypes types_$GOOS.go |go run mkpost.go >ztypes_$GOOSARCH.go.NEW && mv ztypes_$GOOSARCH.go.NEW ztypes_$GOOSARCH.go";
   354	fi
   355	if [ -n "$mkasm" ]; then echo "$mkasm $GOARCH"; fi
   356) | $run

View as plain text