gcc/libgo
2020-09-21 15:42:00 -07:00
..
config
go go/internal/gccgoimporter: recognize aixbigafMagic archives 2020-09-21 15:42:00 -07:00
misc/cgo libgo: update to Go1.15rc2 release 2020-08-07 17:22:33 -07:00
runtime libgo: fix ptrace syscall hooks into glibc 2020-09-17 12:14:09 -07:00
testsuite gotest: use a space rather than a middle dot in target lists 2020-08-27 16:18:01 -07:00
aclocal.m4 libgo: handle --with-toolexeclibdir=. 2020-01-24 06:33:46 -08:00
check-packages.txt libgo: update to go1.15rc1 2020-08-01 11:21:40 -07:00
config.h.in
configure libgo: correctly handle AIX FAT library creation 2020-08-12 11:33:54 -07:00
configure.ac libgo: correctly handle AIX FAT library creation 2020-08-12 11:33:54 -07:00
goarch.sh
godeps.sh
gotool-packages.txt libgo: update to go1.15rc1 2020-08-01 11:21:40 -07:00
libgo-packages.txt libgo: update to go1.15rc1 2020-08-01 11:21:40 -07:00
libgo.imp
LICENSE
Makefile.am libgo: don't put golang.org packages in zstdpkglist.go 2020-09-21 14:11:01 -07:00
Makefile.in libgo: don't put golang.org packages in zstdpkglist.go 2020-09-21 14:11:01 -07:00
match.sh libgo: update to Go1.14beta1 2020-01-21 23:53:22 -08:00
MERGE libgo: update to Go1.15rc2 release 2020-08-07 17:22:33 -07:00
merge.sh libgo: update to Go1.14rc1 release 2020-02-15 09:14:10 -08:00
mkrsysinfo.sh libgo: support gollvm build on arm64 linux 2019-09-19 00:03:25 +00:00
mkruntimeinc.sh
mksigtab.sh
mksysinfo.sh mksysinfo: use type aliases for time struct field types 2019-11-21 01:03:55 +00:00
mvifdiff.sh
PATENTS
README
README.gcc
sysinfo.c libgo: additional type/const references in sysinfo.c 2020-09-15 17:41:57 -07:00
VERSION libgo: update to Go1.15rc2 release 2020-08-07 17:22:33 -07:00

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.