Skip to content

Commit 1700fd2

Browse files
author
Mark Wielaard
committed
fedorahosted used to be our home, but we are now hosted at sourceware. Change the elfutils project home to http://elfutils.org/ Point hosted services (email, release, git, bug tracker and web pages) to https://sourceware.org/elfutils/ Move design notes from README to NOTES. Add URLs for home, releases, bugs, git and mailinglist to README. Make the --version output of all tools the same by using a common print_version function and update the publicly shown copyright holder to the elfutils developers. Signed-off-by: Mark Wielaard <mark@klomp.org>
1 parent 0d0f845 commit 1700fd2

31 files changed

Lines changed: 169 additions & 250 deletions

CONTRIBUTING

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,14 @@
1-
The project homepage is at https://fedorahosted.org/elfutils/
1+
The project home is http://elfutils.org/
22

33
The current elfutils source code can be checked out with
4-
git clone git://git.fedorahosted.org/git/elfutils.git
4+
git clone git://sourceware.org/git/elfutils.git
55

66
The developer mailinglist to send patches to is
7-
elfutils-devel@lists.fedorahosted.org.
8-
https://fedorahosted.org/mailman/listinfo/elfutils-devel
7+
elfutils-devel@sourceware.org.
8+
https://sourceware.org/ml/elfutils-devel/
9+
10+
To subscribe send an email to elfutils-devel-subscribe@sourceware.org
11+
Or use the form at https://sourceware.org/lists.html#ml-requestor
912

1013
Please supply patches using git format-patch or using git send-email.
1114

@@ -66,20 +69,22 @@ After sending your patch to the mailinglist one of the committers
6669
to the project will review it, give feedback, and if perfect they
6770
will commit it for you.
6871

69-
The current maintainers/committers can be found at:
70-
https://admin.fedoraproject.org/accounts/group/members/gitelfutils/*
71-
7272
You can become a maintainer/committer yourself after you have provided
7373
at least a handful of accepted patches and agree to the guidelines in
7474
this document for creating, reviewing, accepting and committing patches.
7575

76-
To become a committer you need an FAS account at:
77-
https://admin.fedoraproject.org/accounts/
76+
To become a committer you need a sourceware account:
77+
https://sourceware.org/cgi-bin/pdw/ps_form.cgi
7878
Upload a SSH public key and have an existing maintainer sponsor you
79-
for the Elf Utils Group (gitelfutils).
79+
for the elfutils group.
8080

8181
committers can push patches through:
82-
ssh://<fasname>@git.fedorahosted.org/git/elfutils.git
82+
ssh://<user>@sourceware.org/git/elfutils.git
83+
84+
The current webpages published at https://sourceware.org/elfutils/
85+
can be checked out with:
86+
git clone ssh://<user>@sourceware.org/git/elfutils-htdocs.git
87+
Patches should also be posted to the mailinglist.
8388

8489
As a maintainer/committer you should still post patches as described
8590
above. And ideally they are reviewed and approved as above. If no
@@ -88,7 +93,7 @@ you may use your own judgement whether you ping your patch or push
8893
it after "self-review". If you do, you should post a message to the
8994
mailinglist that the patch has been pushed.
9095

91-
committers may also create git branches starting with <fasname>/...
96+
committers may also create git branches starting with <nickname>/...
9297
patches on these branches are works in progress, so might not be perfect
9398
yet, but should follow the above guidelines as much as possible and should
9499
be aimed at integration into master. For merging a branch into master

ChangeLog

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,14 @@
1+
2016-12-24 Mark Wielaard <mark@klomp.org>
2+
3+
* README: Move design notes to NOTES. Add URLs for home, releases,
4+
bugs, git and mailinglist now on sourceware.
5+
* NOTES: Add notes from README.
6+
* CONTRIBUTING: Change fedorahosted.org references to new
7+
sourceware.org locations.
8+
* configure.ac (AC_INIT): Add package URL http://elfutils.org/
9+
change bug-report to https://sourceware.org/bugzilla/
10+
(AC_COPYRIGHT): Set to the elfutils developers.
11+
112
2016-11-23 Mark Wielaard <mjw@redhat.com>
213

314
* configure.ac: Add test for bad fts.h. Add -DBAD_FTS=1 to CFLAGS

NOTES

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,25 @@
1+
Fundamental design decision:
2+
3+
- the sizes of external and internal types are assumed to be the same.
4+
This leaves byte ordering aside. While assuming this the code can be
5+
greatly simplified and speed increases. Since no change violating this
6+
assumption is in sight this is believed to be a worthwhile optimization.
7+
8+
- the ABI of the backend modules is not guaranteed. Really, no guarantee
9+
whatsoever. We are enforcing this in the code. The modules and their
10+
users must match. No third-party EBL module are supported or allowed.
11+
The only reason there are separate modules is to not have the code for
12+
all architectures in all the binaries.
13+
14+
- although the public libraries (libasm, libdw) have a stable API and are
15+
backwards ABI compatible they, and the elfutils tools, do depend on each
16+
others internals, and on internals of libelf to provide their interfaces.
17+
So they should always be upgraded in lockstep when packaging the tools
18+
and libraries separately. For one example of how to do that, see the
19+
config/elfutils.spec.
20+
21+
Some notes:
22+
123
- old GNU ld's behavior wrt DSOs seems to be severely broken.
224

325
y.o reference foo()

README

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,22 @@
1-
Fundamental design decision:
2-
3-
- the sizes of external and internal types are assumed to be the same.
4-
This leaves byte ordering aside. While assuming this the code can be
5-
greatly simplified and speed increases. Since no change violating this
6-
assumption is in sight this is believed to be a worthwhile optimization.
7-
8-
- the ABI of the backend modules is not guaranteed. Really, no guarantee
9-
whatsoever. We are enforcing this in the code. The modules and their
10-
users must match. No third-party EBL module are supported or allowed.
11-
The only reason there are separate modules is to not have the code for
12-
all architectures in all the binaries.
13-
14-
- although the public libraries (libasm, libdw) have a stable API and are
15-
backwards ABI compatible they, and the elfutils tools, do depend on each
16-
others internals, and on internals of libelf to provide their interfaces.
17-
So they should always be upgraded in lockstep when packaging the tools
18-
and libraries separately. For one example of how to do that, see the
19-
config/elfutils.spec.
1+
The elfutils project provides libraries and tools for ELF files and DWARF data.
2+
3+
The project home is http://elfutils.org/
4+
5+
Releases are published at ftp://sourceware.org/pub/elfutils/
6+
Which can also be found at https://sourceware.org/elfutils/ftp/
7+
8+
Please reports bugs at https://sourceware.org/bugzilla/
9+
10+
The current elfutils source code can be checked out with
11+
git clone git://sourceware.org/git/elfutils.git
12+
13+
The developer mailinglist to send patches to is
14+
elfutils-devel@sourceware.org.
15+
https://sourceware.org/ml/elfutils-devel/
16+
17+
To subscribe send an email to elfutils-devel-subscribe@sourceware.org
18+
Or use the form at https://sourceware.org/lists.html#ml-requestor
19+
20+
See the CONTRIBUTING file for how to propose patches to the code.
21+
22+
See the NOTES files for some design decisions and notes.

config/ChangeLog

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
2016-12-24 Mark Wielaard <mark@klomp.org>
2+
3+
* libdw.pc.in: Set URL to http://elfutils.org/
4+
* libelf.pc.in: Likewise.
5+
16
2016-11-02 Mark Wielaard <mjw@redhat.com>
27

38
* eu.am: Check HAVE_IMPLICIT_FALLTHROUGH_WARNING.

config/libdw.pc.in

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ includedir=@includedir@
66
Name: libdw
77
Description: elfutils library for DWARF data and ELF file or process inspection
88
Version: @VERSION@
9-
URL: https://fedorahosted.org/elfutils/
9+
URL: http://elfutils.org/
1010

1111
Libs: -L${libdir} -ldw
1212
Cflags: -I${includedir}

config/libelf.pc.in

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ includedir=@includedir@
66
Name: libelf
77
Description: elfutils libelf library to read and write ELF files
88
Version: @VERSION@
9-
URL: https://fedorahosted.org/elfutils/
9+
URL: http://elfutils.org/
1010

1111
Libs: -L${libdir} -lelf
1212
Cflags: -I${includedir}

configure.ac

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ dnl GNU General Public License for more details.
1717
dnl
1818
dnl You should have received a copy of the GNU General Public License
1919
dnl along with this program. If not, see <http://www.gnu.org/licenses/>.
20-
AC_INIT([elfutils],[0.167],[https://bugzilla.redhat.com/],[elfutils])
20+
AC_INIT([elfutils],[0.167],[https://sourceware.org/bugzilla],[elfutils],[http://elfutils.org/])
2121

2222
# We want eu- as default program prefix if none was given by the user.
2323
# But if the user explicitly provided --program-prefix="" then pretend
@@ -35,7 +35,7 @@ fi
3535
AC_CONFIG_AUX_DIR([config])
3636
AC_CONFIG_FILES([config/Makefile])
3737

38-
AC_COPYRIGHT([Copyright (C) 1996-2016 Red Hat, Inc.])
38+
AC_COPYRIGHT([Copyright (C) 1996-2016 The elfutils developers.])
3939
AC_PREREQ(2.63) dnl Minimum Autoconf version required.
4040

4141
dnl We use GNU make extensions; automake 1.10 defaults to -Wportability.

lib/ChangeLog

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,10 @@
1-
2015-10-11 Akihiko Odaki <akihiko.odaki.4i@stu.hosei.ac.jp>
1+
2016-12-24 Mark Wielaard <mark@klomp.org>
2+
3+
* version.c: New source file.
4+
* Makefile.am (libeu_a_SOURCES): Add version.c
5+
* system.h (print_version): New function definition.
6+
7+
2016-10-11 Akihiko Odaki <akihiko.odaki.4i@stu.hosei.ac.jp>
28

39
* fixedsizehash.h (CONCAT): Use __CONCAT when available.
410
* system.h: Include config.h and errno.h.

lib/Makefile.am

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ noinst_LIBRARIES = libeu.a
3535

3636
libeu_a_SOURCES = xstrdup.c xstrndup.c xmalloc.c next_prime.c \
3737
crc32.c crc32_file.c md5.c sha1.c \
38-
color.c
38+
color.c version.c
3939

4040
noinst_HEADERS = fixedsizehash.h libeu.h system.h dynamicsizehash.h list.h \
4141
md5.h sha1.h eu-config.h

0 commit comments

Comments
 (0)