gcc/libgo
Ian Lance Taylor 479872227c runtime: avoid libc memmove and memclr
The libc memmove and memclr don't reliably operate on full memory words.
We already avoided them on PPC64, but the same problem can occur even
on x86, where some processors use "rep movsb" and "rep stosb".
Always use C code that stores full memory words.

While we're here, clean up the C code. We don't need special handling
if the memmove/memclr pointers are not pointer-aligned.

Unfortunately, this will likely be slower. Perhaps some day we can
have our own assembly code that operates a word at a time,
or we can use different operations when we know there are no pointers.

Reviewed-on: https://go-review.googlesource.com/c/gofrontend/+/685178
2025-07-08 15:49:16 -07:00
..
config
go syscall: pass correct pointer to system call in recvmsgRaw 2025-07-08 15:01:25 -07:00
misc/cgo libgo: revert incorrectly committed change 2023-03-05 20:01:56 -08:00
runtime runtime: avoid libc memmove and memclr 2025-07-08 15:49:16 -07:00
testsuite libgo: fix DejaGNU testsuite compiler when using build sysroot 2023-09-12 13:19:42 -07:00
LICENSE
MERGE libgo: update to final Go 1.18 release 2022-03-16 13:52:32 -07:00
Makefile.am libgo: better error messages for unknown GOARCH/GOOS 2024-02-02 15:10:02 -08:00
Makefile.in libgo: better error messages for unknown GOARCH/GOOS 2024-02-02 15:10:02 -08:00
PATENTS
README
README.gcc libgo: update README.gcc 2022-02-22 15:34:46 -08:00
VERSION libgo: update to final Go 1.18 release 2022-03-16 13:52:32 -07:00
aclocal.m4
check-packages.txt libgo: update to Go1.18beta2 2022-02-11 15:01:19 -08:00
config.h.in libgo: permit loff_t and off_t to be macros 2022-06-17 14:27:06 -07:00
configure libgo: bump libgo version for GCC 15 release 2025-03-04 11:43:22 -08:00
configure.ac libgo: bump libgo version for GCC 15 release 2025-03-04 11:43:22 -08:00
goarch.sh
godeps.sh
gotool-packages.txt libgo: move golang.org/x/sync/semaphore to gotool packages 2022-03-04 10:27:10 -08:00
libgo-packages.txt libgo: move golang.org/x/sync/semaphore to gotool packages 2022-03-04 10:27:10 -08:00
libgo.imp
match.sh libgo: use POSIX shell arithmetic expansion 2022-07-22 11:57:18 -07:00
merge.sh libgo: update to final Go 1.18 release 2022-03-16 13:52:32 -07:00
mklinknames.awk
mkrsysinfo.sh compiler, libgo: don't pad sparc64-linux epollevent 2021-12-29 15:52:23 -08:00
mkruntimeinc.sh mkruntimeinc: skip _FILE 2022-03-04 10:46:55 -08:00
mksigtab.sh libgo: only add signum to siglist if it doesn't exist yet 2022-04-18 15:17:16 -07:00
mksysinfo.sh libgo: handle stat st_atim32 field and SYS_SECCOMP 2022-06-30 12:35:08 -07:00
mvifdiff.sh
sysinfo.c libgo: use SYS_timer_settime32 2022-07-30 10:35:23 -07:00

README

See ../README.

This is the runtime support library for the Go programming language.
This library is intended for use with the Go frontend.

This library should not be stripped when it is installed.  Go code
relies on being able to look up file/line information, which comes
from the debugging info using the libbacktrace library.

The library has only been tested on GNU/Linux using glibc, and on
Solaris.  It should not be difficult to port to other operating
systems.

Directories:

go
  A copy of the Go library from http://golang.org/, with several
  changes for gccgo.

runtime
  Runtime functions, written in C, which are called directly by the
  compiler or by the library.

Contributing
============

To contribute patches to the files in this directory, please see
http://golang.org/doc/gccgo_contribute.html .

The master copy of these files is hosted at
http://code.google.com/p/gofrontend .  Changes to these files require
signing a Google contributor license agreement.  If you are the
copyright holder, you will need to agree to the individual contributor
license agreement at
http://code.google.com/legal/individual-cla-v1.0.html.  This agreement
can be completed online.

If your organization is the copyright holder, the organization will
need to agree to the corporate contributor license agreement at
http://code.google.com/legal/corporate-cla-v1.0.html.

If the copyright holder for your code has already completed the
agreement in connection with another Google open source project, it
does not need to be completed again.

Debugging
=========

This describes how to test libgo when built as part of gccgo.

To test a specific package, cd to the libgo build directory
(TARGET/libgo) and run `make PKG/check`.  For example, `make
bytes/check`.

To see the exact commands that it runs, including how the compiler is
invoked, run `make GOTESTFLAGS=--trace bytes/check`.  This will
display the commands if the test fails.  If the test passes, the
commands and other output will be visible in a file named
check-testlog in a subdirectory with the name of the package being
checked.  In the case of bytes/check, this will create
bytes/check-testlog.

To leave the test program behind, run `make GOTESTFLAGS=--keep
bytes/check`.  That will leave a gotestNNNN/test directory in the
libgo build directory.  In that directory you can run
`LD_LIBRARY_PATH=../../.libs ./a.out -test.short` to run the tests.
You can run specific failing tests using a -test.run option.  You can
see the tests being run with the -test.v option.  You can run the
program under a debugger such as gdb.