source: mainline/kernel/Makefile@ 43b8c65

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 43b8c65 was 43b8c65, checked in by Adam Hraska <adam.hraska+hos@…>, 13 years ago

Added syscall smp_memory_barrier.

  • Property mode set to 100644
File size: 13.4 KB
RevLine 
[e16e036a]1#
[df4ed85]2# Copyright (c) 2005 Martin Decky
[e16e036a]3# All rights reserved.
4#
5# Redistribution and use in source and binary forms, with or without
6# modification, are permitted provided that the following conditions
7# are met:
8#
9# - Redistributions of source code must retain the above copyright
10# notice, this list of conditions and the following disclaimer.
11# - Redistributions in binary form must reproduce the above copyright
12# notice, this list of conditions and the following disclaimer in the
13# documentation and/or other materials provided with the distribution.
14# - The name of the author may not be used to endorse or promote products
15# derived from this software without specific prior written permission.
16#
17# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27#
28
[4e9aaf5]29## Configuration
30#
31
32ROOT_PATH = ..
33
34VERSION_DEF = $(ROOT_PATH)/version
35
36COMMON_MAKEFILE = $(ROOT_PATH)/Makefile.common
37COMMON_HEADER = $(ROOT_PATH)/common.h
38COMMON_HEADER_ARCH = arch/$(KARCH)/include/common.h
39
40CONFIG_MAKEFILE = $(ROOT_PATH)/Makefile.config
41CONFIG_HEADER = $(ROOT_PATH)/config.h
42
43-include $(VERSION_DEF)
44-include $(COMMON_MAKEFILE)
45-include $(CONFIG_MAKEFILE)
46
47## Common names
48#
49
50DEPEND = Makefile.depend
51DEPEND_PREV = $(DEPEND).prev
52RAW = kernel.raw
53BIN = kernel.bin
54MAP = kernel.map
55JOB = kernel.job
56MAP_PREV = $(MAP).prev
57DISASM = kernel.disasm
58DUMP = kernel.dump
59REAL_MAP = generic/src/debug/real_map
60
[c0699467]61ABI_INCLUDE = generic/include/abi
[4e9aaf5]62ARCH_INCLUDE = generic/include/arch
63GENARCH_INCLUDE = generic/include/genarch
64
65GENMAP = tools/genmap.py
66JOBFILE = $(ROOT_PATH)/tools/jobfile.py
67
68LINK = arch/$(KARCH)/_link.ld
69EMPTY_MAP = generic/src/debug/empty_map.o
70SIZEOK_MAP = generic/src/debug/sizeok_map.o
71
[cc1f8d4]72.PHONY: all clean
[e16e036a]73
[4e9aaf5]74all: $(VERSION_DEF) $(COMMON_MAKEFILE) $(COMMON_HEADER) $(CONFIG_MAKEFILE) $(CONFIG_HEADER) $(BIN) $(DISASM)
75 -[ -f $(DEPEND) ] && cp -a $(DEPEND) $(DEPEND_PREV)
[c9ed176]76
[e16e036a]77clean:
[c0699467]78 rm -f $(DEPEND) $(DEPEND_PREV) $(RAW) $(BIN) $(MAP) $(JOB) $(MAP_PREV) $(DISASM) $(DUMP) $(REAL_MAP).* $(ABI_INCLUDE) $(ARCH_INCLUDE) $(GENARCH_INCLUDE) arch/*/_link.ld arch/*/include/common.h
[839470f]79 find generic/src/ arch/*/src/ genarch/src/ test/ -name '*.o' -follow -exec rm \{\} \;
[4e9aaf5]80
81## Common compiler flags
82#
83
[7c682dd1]84INCLUDES = generic/include
[1cb092d]85
86ifeq ($(CONFIG_OPTIMIZE_FOR_SIZE),y)
[938f227]87 OPTIMIZATION = s
[1cb092d]88else
[f8d07859]89 OPTIMIZATION = 3
[1cb092d]90endif
[7c682dd1]91
[d9faae91]92DEFS = -DKERNEL -DRELEASE=$(RELEASE) "-DCOPYRIGHT=$(COPYRIGHT)" "-DNAME=$(NAME)" -D__$(BITS)_BITS__ -D__$(ENDIANESS)__
[4e9aaf5]93
[7c682dd1]94GCC_CFLAGS = -I$(INCLUDES) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
[4e9aaf5]95 -fexec-charset=UTF-8 -fwide-exec-charset=UTF-32$(ENDIANESS) \
96 -finput-charset=UTF-8 -ffreestanding -fno-builtin -nostdlib -nostdinc \
[e8c5c11]97 -std=gnu99 -Wall -Wextra -Wno-unused-parameter -Wmissing-prototypes \
[4e9aaf5]98 -Werror-implicit-function-declaration -Wwrite-strings \
[e805e2f]99 -pipe
[4e9aaf5]100
[7c682dd1]101ICC_CFLAGS = -I$(INCLUDES) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
[4e9aaf5]102 -ffreestanding -fno-builtin -nostdlib -nostdinc -Wall -Wmissing-prototypes \
[e805e2f]103 -Werror-implicit-function-declaration -wd170
[4e9aaf5]104
[7c682dd1]105CLANG_CFLAGS = -I$(INCLUDES) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
[4e9aaf5]106 -fexec-charset=UTF-8 -fwide-exec-charset=UTF-32$(ENDIANESS) \
107 -finput-charset=UTF-8 -ffreestanding -fno-builtin -nostdlib -nostdinc \
108 -Wall -Wextra -Wno-unused-parameter -Wmissing-prototypes \
109 -Werror-implicit-function-declaration -Wwrite-strings \
110 -pipe -arch $(CLANG_ARCH)
111
[e805e2f]112ifeq ($(CONFIG_DEBUG),y)
113 GCC_CFLAGS += -Werror
114 ICC_CFLAGS += -Werror
115endif
116
[cf84f1bf]117ifeq ($(CONFIG_LTO),y)
118 GCC_CFLAGS += -flto
119endif
120
[9ded977]121ifeq ($(CONFIG_LINE_DEBUG),y)
122 GCC_CFLAGS += -g
123 ICC_CFLAGS += -g
124 CLANG_CFLAGS += -g
125endif
126
[510bc07]127#
128# Mind the mutual ordering with the inclusion of the arch Makefile.inc.
129# AFLAGS and LFLAGS must be initialized before the inclusion.
130#
131AFLAGS =
[afdcc60e]132LFLAGS = -n -T $(LINK) -M
[510bc07]133
134#
135# Mind the mutual ordering with the initialization of AFLAGS and LFLAGS.
136# The arch Makefile.inc must be included after the initialization.
137#
[4e9aaf5]138-include arch/$(KARCH)/Makefile.inc
139-include genarch/Makefile.inc
140-include $(DEPEND)
141
142## The at-sign
143#
144# The $(ATSIGN) variable holds the ASCII character representing the at-sign
145# ('@') used in various $(AS) constructs (e.g. @progbits). On architectures that
146# don't use '@' for starting a comment, $(ATSIGN) is merely '@'. However, on
147# those that do use it for starting a comment (e.g. arm32), $(ATSIGN) must be
148# defined as the percentile-sign ('%') in the architecture-dependent
149# Makefile.inc.
150#
151
152ATSIGN ?= @
153
154## Cross-platform assembly to start a symtab.data section
155#
156
157SYMTAB_SECTION = ".section symtab.data, \"a\", $(ATSIGN)progbits;"
158
159## Compilation options
160#
161
162ifeq ($(COMPILER),gcc_native)
163 CFLAGS = $(GCC_CFLAGS)
164 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
[263bda2]165 INSTRUMENTATION = -finstrument-functions
[4e9aaf5]166endif
167
168ifeq ($(COMPILER),gcc_cross)
169 CFLAGS = $(GCC_CFLAGS)
170 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
[263bda2]171 INSTRUMENTATION = -finstrument-functions
[4e9aaf5]172endif
173
174ifeq ($(COMPILER),icc)
175 CFLAGS = $(ICC_CFLAGS)
176 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
[263bda2]177 INSTRUMENTATION =
[4e9aaf5]178endif
179
180ifeq ($(COMPILER),clang)
181 CFLAGS = $(CLANG_CFLAGS)
182 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
[263bda2]183 INSTRUMENTATION =
[4e9aaf5]184endif
185
[cf84f1bf]186
[4e9aaf5]187## Generic kernel sources
188#
189
190GENERIC_SOURCES = \
191 generic/src/adt/avl.c \
192 generic/src/adt/bitmap.c \
193 generic/src/adt/btree.c \
[14c9aa6]194 generic/src/adt/cht.c \
[4e9aaf5]195 generic/src/adt/hash_table.c \
196 generic/src/adt/list.c \
197 generic/src/console/chardev.c \
198 generic/src/console/console.c \
[f0d7bd9]199 generic/src/console/prompt.c \
[4e9aaf5]200 generic/src/cpu/cpu.c \
[22b5924]201 generic/src/cpu/cpu_mask.c \
[4e9aaf5]202 generic/src/ddi/ddi.c \
203 generic/src/ddi/irq.c \
204 generic/src/ddi/device.c \
205 generic/src/debug/symtab.c \
206 generic/src/debug/stacktrace.c \
[06737a0]207 generic/src/debug/panic.c \
[263bda2]208 generic/src/debug/debug.c \
[4e9aaf5]209 generic/src/interrupt/interrupt.c \
210 generic/src/main/main.c \
211 generic/src/main/kinit.c \
212 generic/src/main/uinit.c \
213 generic/src/main/version.c \
214 generic/src/main/shutdown.c \
215 generic/src/proc/program.c \
216 generic/src/proc/scheduler.c \
217 generic/src/proc/thread.c \
218 generic/src/proc/task.c \
219 generic/src/proc/the.c \
220 generic/src/syscall/syscall.c \
221 generic/src/syscall/copy.c \
[622f409]222 generic/src/mm/km.c \
[630a8ef]223 generic/src/mm/reserve.c \
[4e9aaf5]224 generic/src/mm/buddy.c \
225 generic/src/mm/frame.c \
226 generic/src/mm/page.c \
227 generic/src/mm/tlb.c \
228 generic/src/mm/as.c \
229 generic/src/mm/backend_anon.c \
230 generic/src/mm/backend_elf.c \
231 generic/src/mm/backend_phys.c \
232 generic/src/mm/slab.c \
233 generic/src/lib/func.c \
234 generic/src/lib/memstr.c \
[3abfe9a8]235 generic/src/lib/memfnc.c \
[4e9aaf5]236 generic/src/lib/sort.c \
[19f857a]237 generic/src/lib/str.c \
[4e9aaf5]238 generic/src/lib/elf.c \
[9fe7d6c]239 generic/src/lib/ra.c \
[4e9aaf5]240 generic/src/lib/rd.c \
241 generic/src/printf/printf_core.c \
242 generic/src/printf/printf.c \
243 generic/src/printf/snprintf.c \
244 generic/src/printf/vprintf.c \
245 generic/src/printf/vsnprintf.c \
246 generic/src/time/clock.c \
247 generic/src/time/timeout.c \
248 generic/src/time/delay.c \
249 generic/src/preempt/preemption.c \
250 generic/src/synch/spinlock.c \
251 generic/src/synch/condvar.c \
252 generic/src/synch/mutex.c \
253 generic/src/synch/semaphore.c \
254 generic/src/synch/smc.c \
[43b8c65]255 generic/src/synch/smp_memory_barrier.c \
[4e9aaf5]256 generic/src/synch/waitq.c \
257 generic/src/synch/futex.c \
[8a64e81e]258 generic/src/synch/workqueue.c \
[79d74fe]259 generic/src/synch/rcu.c \
[4e9aaf5]260 generic/src/smp/ipi.c \
261 generic/src/smp/smp.c \
[2ee1ccc]262 generic/src/smp/smp_call.c \
[4e9aaf5]263 generic/src/ipc/ipc.c \
264 generic/src/ipc/sysipc.c \
[f0defd2]265 generic/src/ipc/sysipc_ops.c \
266 generic/src/ipc/ops/clnestab.c \
267 generic/src/ipc/ops/conctmeto.c \
268 generic/src/ipc/ops/concttome.c \
269 generic/src/ipc/ops/connclone.c \
270 generic/src/ipc/ops/dataread.c \
271 generic/src/ipc/ops/datawrite.c \
272 generic/src/ipc/ops/debug.c \
273 generic/src/ipc/ops/sharein.c \
274 generic/src/ipc/ops/shareout.c \
275 generic/src/ipc/ops/stchngath.c \
[4e9aaf5]276 generic/src/ipc/ipcrsc.c \
277 generic/src/ipc/irq.c \
278 generic/src/ipc/event.c \
279 generic/src/security/cap.c \
[18b5402c]280 generic/src/sysinfo/sysinfo.c \
[9dae191e]281 generic/src/sysinfo/stats.c
[4e9aaf5]282
283## Kernel console support
284#
285
286ifeq ($(CONFIG_KCONSOLE),y)
287GENERIC_SOURCES += \
288 generic/src/console/kconsole.c \
289 generic/src/console/cmd.c
290endif
291
292## Udebug interface sources
293#
294
295ifeq ($(CONFIG_UDEBUG),y)
296GENERIC_SOURCES += \
297 generic/src/ipc/kbox.c \
298 generic/src/udebug/udebug.c \
299 generic/src/udebug/udebug_ops.c \
300 generic/src/udebug/udebug_ipc.c
301endif
302
303## Test sources
304#
305
306ifeq ($(CONFIG_TEST),y)
307 CFLAGS += -Itest/
308 GENERIC_SOURCES += \
309 test/test.c \
310 test/atomic/atomic1.c \
311 test/btree/btree1.c \
[0949b7a]312 test/cht/cht1.c \
[4e9aaf5]313 test/avltree/avltree1.c \
314 test/fault/fault1.c \
315 test/mm/falloc1.c \
316 test/mm/falloc2.c \
317 test/mm/mapping1.c \
318 test/mm/slab1.c \
319 test/mm/slab2.c \
320 test/synch/semaphore1.c \
321 test/synch/semaphore2.c \
[8a64e81e]322 test/synch/workqueue2.c \
323 test/synch/workqueue3.c \
[9f8745c5]324 test/synch/rcu1.c \
[4e9aaf5]325 test/print/print1.c \
326 test/print/print2.c \
327 test/print/print3.c \
328 test/print/print4.c \
[855e0d8]329 test/print/print5.c \
[d71331b]330 test/thread/thread1.c \
331 test/smpcall/smpcall1.c
[4e9aaf5]332
333 ifeq ($(KARCH),mips32)
334 GENERIC_SOURCES += test/debug/mips1.c
335 else
336 GENERIC_SOURCES += test/debug/mips1_skip.c
337 endif
338
339 ifeq ($(KARCH),ia64)
340 GENERIC_SOURCES += test/mm/purge1.c
341 else
342 GENERIC_SOURCES += test/mm/purge1_skip.c
343 endif
344
345endif
346
[263bda2]347## Sources where instrumentation is enabled
348#
349
[da52547]350ifeq ($(CONFIG_TRACE),y)
[7a0359b]351 INSTRUMENTED_SOURCES = \
352 generic/src/adt/btree.c \
353 generic/src/cpu/cpu.c \
354 generic/src/ddi/ddi.c \
355 generic/src/interrupt/interrupt.c \
356 generic/src/main/main.c \
357 generic/src/main/kinit.c \
358 generic/src/proc/the.c \
359 generic/src/mm/frame.c \
360 generic/src/mm/page.c \
361 generic/src/mm/tlb.c \
362 generic/src/mm/as.c \
363 generic/src/mm/slab.c \
364 generic/src/sysinfo/sysinfo.c \
365 generic/src/console/kconsole.c
366else
367 INSTRUMENTED_SOURCES =
[263bda2]368endif
369
[4e9aaf5]370GENERIC_OBJECTS := $(addsuffix .o,$(basename $(GENERIC_SOURCES)))
371ARCH_OBJECTS := $(addsuffix .o,$(basename $(ARCH_SOURCES)))
372GENARCH_OBJECTS := $(addsuffix .o,$(basename $(GENARCH_SOURCES)))
373
[cf84f1bf]374LFLAGS_LTO := $(addprefix -Xlinker ,$(LFLAGS))
375
[4e9aaf5]376ifeq ($(CONFIG_SYMTAB),y)
377 SYMTAB_OBJECTS := generic/src/debug/real_map.o
378else
379 SYMTAB_OBJECTS :=
380endif
381
382$(BIN): $(RAW)
383 $(OBJCOPY) -O $(BFD) $< $@
384
385$(DISASM): $(RAW)
[9ded977]386ifeq ($(CONFIG_LINE_DEBUG),y)
387 $(OBJDUMP) -d -S $< > $@
388else
[4e9aaf5]389 $(OBJDUMP) -d $< > $@
[9ded977]390endif
[4e9aaf5]391
392$(RAW): $(LINK) $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(SYMTAB_OBJECTS)
[cf84f1bf]393ifeq ($(CONFIG_LTO),y)
394 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SYMTAB_OBJECTS)
395else
396 $(LD) $(LFLAGS) -Map $(MAP) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SYMTAB_OBJECTS)
397endif
[1cb092d]398ifeq ($(CONFIG_STRIP_BINARIES),y)
[cf84f1bf]399 $(STRIP) $(RAW)
[1cb092d]400endif
[4e9aaf5]401
402$(LINK): $(LINK).in $(DEPEND)
403 $(GCC) $(DEFS) $(GCC_CFLAGS) -D__ASM__ -D__LINKER__ -E -x c $< | grep -v "^\#" > $@
404
405%.o: %.S $(DEPEND)
[cf84f1bf]406 $(GCC) $(DEFS) $(GCC_CFLAGS) -D__ASM__ -c -o $@ $<
[4e9aaf5]407ifeq ($(PRECHECK),y)
408 $(JOBFILE) $(JOB) $< $@ as asm/preproc $(DEFS) $(GCC_CFLAGS) -D__ASM__
409endif
410
411%.o: %.s $(DEPEND)
[7c682dd1]412 $(AS) $(AFLAGS) -o $@ $<
[4e9aaf5]413ifeq ($(PRECHECK),y)
414 $(JOBFILE) $(JOB) $< $@ as asm $(DEFS) $(CFLAGS) $(EXTRA_FLAGS)
415endif
416
417%.o: %.c $(DEPEND)
[263bda2]418 $(CC) $(DEFS) $(CFLAGS) $(EXTRA_FLAGS) $(FPU_NO_CFLAGS) $(if $(findstring $<,$(INSTRUMENTED_SOURCES)),$(INSTRUMENTATION)) -c -o $@ $<
[4e9aaf5]419ifeq ($(PRECHECK),y)
420 $(JOBFILE) $(JOB) $< $@ cc core $(DEFS) $(CFLAGS) $(EXTRA_FLAGS) $(FPU_NO_CFLAGS)
421endif
422
423$(REAL_MAP).o: $(REAL_MAP).bin
424 echo $(SYMTAB_SECTION)" .incbin \"$<\"" | $(AS) $(AFLAGS) -o $@
425
426$(REAL_MAP).bin: $(LINK) $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS)
427 echo $(SYMTAB_SECTION) | $(AS) $(AFLAGS) -o $(EMPTY_MAP)
[cf84f1bf]428ifeq ($(CONFIG_LTO),y)
429 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP_PREV) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(EMPTY_MAP)
430else
431 $(LD) $(LFLAGS) -Map $(MAP_PREV) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(EMPTY_MAP)
432endif
[4e9aaf5]433 $(OBJDUMP) -t $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) > $(DUMP)
434 $(GENMAP) $(MAP_PREV) $(DUMP) $@
435
436 # Do it once again, this time to get correct even the symbols
437 # on architectures that have bss after symtab
438
439 echo $(SYMTAB_SECTION)" .incbin \"$@\"" | $(AS) $(AFLAGS) -o $(SIZEOK_MAP)
[cf84f1bf]440ifeq ($(CONFIG_LTO),y)
441 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP_PREV) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SIZEOK_MAP)
442else
443 $(LD) $(LFLAGS) -Map $(MAP_PREV) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SIZEOK_MAP)
444endif
[4e9aaf5]445 $(OBJDUMP) -t $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) > $(DUMP)
446 $(GENMAP) $(MAP_PREV) $(DUMP) $@
447
[c0699467]448$(DEPEND): $(ABI_INCLUDE) $(ARCH_INCLUDE) $(GENARCH_INCLUDE) $(COMMON_HEADER_ARCH)
[4e9aaf5]449 makedepend -f - -- $(DEPEND_DEFS) $(CFLAGS) -- $(ARCH_SOURCES) $(GENARCH_SOURCES) $(GENERIC_SOURCES) > $@ 2> /dev/null
450 -[ -f $(DEPEND_PREV) ] && diff -q $(DEPEND_PREV) $@ && mv -f $(DEPEND_PREV) $@
451
[c0699467]452$(ABI_INCLUDE): ../abi/include/
453 ln -sfn ../../$< $@
454
[4e9aaf5]455$(ARCH_INCLUDE): arch/$(KARCH)/include/
456 ln -sfn ../../$< $@
457
458$(GENARCH_INCLUDE): genarch/include/
459 ln -sfn ../../$< $@
460
461$(COMMON_HEADER_ARCH): $(COMMON_HEADER)
462 ln -sfn ../../../$< $@
Note: See TracBrowser for help on using the repository browser.