source: mainline/kernel/Makefile@ ba1ea40

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since ba1ea40 was 072607b, checked in by Jakub Jermar <jakub@…>, 9 years ago

Add IPC_M_PAGE_IN system method
  • Property mode set to 100644
File size: 14.7 KB
Line 
1#
2# Copyright (c) 2005 Martin Decky
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
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/arch/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
50AGDEPEND = Makefile.ag.depend
51DEPEND = Makefile.depend
52DEPEND_PREV = $(DEPEND).prev
53RAW = kernel.raw
54BIN = kernel.bin
55MAP = kernel.map
56JOB = kernel.job
57MAP_PREV = $(MAP).prev
58DISASM = kernel.disasm
59DUMP = kernel.dump
60REAL_MAP = generic/src/debug/real_map
61
62GENMAP = tools/genmap.py
63JOBFILE = $(ROOT_PATH)/tools/jobfile.py
64
65LINK = arch/$(KARCH)/_link.ld
66EMPTY_MAP = generic/src/debug/empty_map.o
67SIZEOK_MAP = generic/src/debug/sizeok_map.o
68
69.PHONY: all clean autogen_clean
70
71all: $(VERSION_DEF) $(COMMON_MAKEFILE) $(COMMON_HEADER) $(CONFIG_MAKEFILE) $(CONFIG_HEADER) $(BIN) $(DISASM)
72 -[ -f $(DEPEND) ] && cp -a $(DEPEND) $(DEPEND_PREV)
73
74clean: autogen_clean
75 rm -f $(DEPEND) $(DEPEND_PREV) $(RAW) $(BIN) $(MAP) $(JOB) $(MAP_PREV) $(DISASM) $(DUMP) $(REAL_MAP).* arch/*/_link.ld arch/*/include/arch/common.h
76 find generic/src/ arch/*/src/ genarch/src/ test/ -name '*.o' -follow -exec rm '{}' \;
77
78## Common compiler flags
79#
80
81INCLUDES = generic/include genarch/include arch/$(KARCH)/include ../abi/include
82INCLUDES_FLAGS = $(addprefix -I,$(INCLUDES))
83
84ifeq ($(CONFIG_OPTIMIZE_FOR_SIZE),y)
85 OPTIMIZATION = s
86else
87 OPTIMIZATION = 3
88endif
89
90DEFS = -DKERNEL -DRELEASE=$(RELEASE) "-DCOPYRIGHT=$(COPYRIGHT)" "-DNAME=$(NAME)" -D__$(BITS)_BITS__ -D__$(ENDIANESS)__
91
92GCC_CFLAGS = $(INCLUDES_FLAGS) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
93 -fexec-charset=UTF-8 -fwide-exec-charset=UTF-32$(ENDIANESS) \
94 -finput-charset=UTF-8 -ffreestanding -fno-builtin -nostdlib -nostdinc \
95 -std=gnu99 -Wall -Wextra -Wno-unused-parameter -Wmissing-prototypes \
96 -Werror-implicit-function-declaration -Wwrite-strings \
97 -pipe
98
99ICC_CFLAGS = $(INCLUDES_FLAGS) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
100 -ffreestanding -fno-builtin -nostdlib -nostdinc -Wall -Wmissing-prototypes \
101 -Werror-implicit-function-declaration -wd170
102
103# clang does not support following options but I am not sure whether
104# something won't break because of that:
105# -fexec-charset=UTF-8 -fwide-exec-charset=UTF-32$(ENDIANESS) -finput-charset=UTF-8
106CLANG_CFLAGS = $(INCLUDES_FLAGS) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
107 -ffreestanding -fno-builtin -nostdlib -nostdinc \
108 -std=gnu99 -Wall -Werror -Wextra -Wno-unused-parameter -Wmissing-prototypes \
109 -Werror-implicit-function-declaration -Wwrite-strings \
110 -integrated-as -pipe -target $(CLANG_TARGET)
111
112ifeq ($(CONFIG_DEBUG),y)
113 GCC_CFLAGS += -Werror
114 ICC_CFLAGS += -Werror
115endif
116
117ifeq ($(CONFIG_LTO),y)
118 GCC_CFLAGS += -flto
119endif
120
121ifeq ($(CONFIG_LINE_DEBUG),y)
122 GCC_CFLAGS += -g
123 ICC_CFLAGS += -g
124 CLANG_CFLAGS += -g
125endif
126
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 = --fatal-warnings
132LFLAGS = -n -T $(LINK) -M --fatal-warnings
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#
138-include arch/$(KARCH)/Makefile.inc
139-include genarch/Makefile.inc
140-include $(DEPEND)
141-include $(AGDEPEND)
142
143## The at-sign
144#
145# The $(ATSIGN) variable holds the ASCII character representing the at-sign
146# ('@') used in various $(AS) constructs (e.g. @progbits). On architectures that
147# don't use '@' for starting a comment, $(ATSIGN) is merely '@'. However, on
148# those that do use it for starting a comment (e.g. arm32), $(ATSIGN) must be
149# defined as the percentile-sign ('%') in the architecture-dependent
150# Makefile.inc.
151#
152
153ATSIGN ?= @
154
155## Cross-platform assembly to start a symtab.data section
156#
157
158SYMTAB_SECTION = ".section symtab.data, \"a\", $(ATSIGN)progbits;"
159
160## Compilation options
161#
162
163ifeq ($(COMPILER),gcc_native)
164 CFLAGS = $(GCC_CFLAGS)
165 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
166 INSTRUMENTATION = -finstrument-functions
167endif
168
169ifeq ($(COMPILER),gcc_cross)
170 CFLAGS = $(GCC_CFLAGS)
171 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
172 INSTRUMENTATION = -finstrument-functions
173endif
174
175ifeq ($(COMPILER),gcc_helenos)
176 CFLAGS = $(GCC_CFLAGS)
177 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
178 INSTRUMENTATION = -finstrument-functions
179endif
180
181ifeq ($(COMPILER),icc)
182 CFLAGS = $(ICC_CFLAGS)
183 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
184 INSTRUMENTATION =
185endif
186
187ifeq ($(COMPILER),clang)
188 CFLAGS = $(CLANG_CFLAGS)
189 DEPEND_DEFS = $(DEFS) $(CONFIG_DEFS)
190 INSTRUMENTATION =
191endif
192
193
194## Generic kernel sources
195#
196
197GENERIC_SOURCES = \
198 generic/src/adt/avl.c \
199 generic/src/adt/bitmap.c \
200 generic/src/adt/btree.c \
201 generic/src/adt/cht.c \
202 generic/src/adt/hash_table.c \
203 generic/src/adt/list.c \
204 generic/src/console/chardev.c \
205 generic/src/console/console.c \
206 generic/src/console/prompt.c \
207 generic/src/cpu/cpu.c \
208 generic/src/cpu/cpu_mask.c \
209 generic/src/ddi/ddi.c \
210 generic/src/ddi/irq.c \
211 generic/src/ddi/device.c \
212 generic/src/debug/symtab.c \
213 generic/src/debug/stacktrace.c \
214 generic/src/debug/panic.c \
215 generic/src/debug/debug.c \
216 generic/src/interrupt/interrupt.c \
217 generic/src/log/log.c \
218 generic/src/main/main.c \
219 generic/src/main/kinit.c \
220 generic/src/main/uinit.c \
221 generic/src/main/version.c \
222 generic/src/main/shutdown.c \
223 generic/src/proc/program.c \
224 generic/src/proc/scheduler.c \
225 generic/src/proc/thread.c \
226 generic/src/proc/task.c \
227 generic/src/proc/the.c \
228 generic/src/syscall/syscall.c \
229 generic/src/syscall/copy.c \
230 generic/src/mm/km.c \
231 generic/src/mm/reserve.c \
232 generic/src/mm/frame.c \
233 generic/src/mm/page.c \
234 generic/src/mm/tlb.c \
235 generic/src/mm/as.c \
236 generic/src/mm/backend_anon.c \
237 generic/src/mm/backend_elf.c \
238 generic/src/mm/backend_phys.c \
239 generic/src/mm/backend_user.c \
240 generic/src/mm/slab.c \
241 generic/src/lib/func.c \
242 generic/src/lib/memstr.c \
243 generic/src/lib/memfnc.c \
244 generic/src/lib/sort.c \
245 generic/src/lib/str.c \
246 generic/src/lib/elf.c \
247 generic/src/lib/ra.c \
248 generic/src/lib/rd.c \
249 generic/src/printf/printf_core.c \
250 generic/src/printf/printf.c \
251 generic/src/printf/snprintf.c \
252 generic/src/printf/vprintf.c \
253 generic/src/printf/vsnprintf.c \
254 generic/src/time/clock.c \
255 generic/src/time/timeout.c \
256 generic/src/time/delay.c \
257 generic/src/preempt/preemption.c \
258 generic/src/synch/spinlock.c \
259 generic/src/synch/condvar.c \
260 generic/src/synch/mutex.c \
261 generic/src/synch/semaphore.c \
262 generic/src/synch/smc.c \
263 generic/src/synch/smp_memory_barrier.c \
264 generic/src/synch/waitq.c \
265 generic/src/synch/futex.c \
266 generic/src/synch/workqueue.c \
267 generic/src/synch/rcu.c \
268 generic/src/smp/ipi.c \
269 generic/src/smp/smp.c \
270 generic/src/smp/smp_call.c \
271 generic/src/ipc/ipc.c \
272 generic/src/ipc/sysipc.c \
273 generic/src/ipc/sysipc_ops.c \
274 generic/src/ipc/ops/clnestab.c \
275 generic/src/ipc/ops/conctmeto.c \
276 generic/src/ipc/ops/concttome.c \
277 generic/src/ipc/ops/connclone.c \
278 generic/src/ipc/ops/dataread.c \
279 generic/src/ipc/ops/datawrite.c \
280 generic/src/ipc/ops/debug.c \
281 generic/src/ipc/ops/pagein.c \
282 generic/src/ipc/ops/sharein.c \
283 generic/src/ipc/ops/shareout.c \
284 generic/src/ipc/ops/stchngath.c \
285 generic/src/ipc/ipcrsc.c \
286 generic/src/ipc/irq.c \
287 generic/src/ipc/event.c \
288 generic/src/security/cap.c \
289 generic/src/sysinfo/sysinfo.c \
290 generic/src/sysinfo/stats.c
291
292## Kernel console support
293#
294
295ifeq ($(CONFIG_KCONSOLE),y)
296GENERIC_SOURCES += \
297 generic/src/console/kconsole.c \
298 generic/src/console/cmd.c
299endif
300
301## Udebug interface sources
302#
303
304ifeq ($(CONFIG_UDEBUG),y)
305GENERIC_SOURCES += \
306 generic/src/ipc/kbox.c \
307 generic/src/udebug/udebug.c \
308 generic/src/udebug/udebug_ops.c \
309 generic/src/udebug/udebug_ipc.c
310endif
311
312## Test sources
313#
314
315ifeq ($(CONFIG_TEST),y)
316 CFLAGS += -Itest/
317 GENERIC_SOURCES += \
318 test/test.c \
319 test/atomic/atomic1.c \
320 test/btree/btree1.c \
321 test/cht/cht1.c \
322 test/avltree/avltree1.c \
323 test/fault/fault1.c \
324 test/mm/falloc1.c \
325 test/mm/falloc2.c \
326 test/mm/mapping1.c \
327 test/mm/slab1.c \
328 test/mm/slab2.c \
329 test/synch/semaphore1.c \
330 test/synch/semaphore2.c \
331 test/synch/workqueue2.c \
332 test/synch/workqueue3.c \
333 test/synch/rcu1.c \
334 test/print/print1.c \
335 test/print/print2.c \
336 test/print/print3.c \
337 test/print/print4.c \
338 test/print/print5.c \
339 test/thread/thread1.c \
340 test/smpcall/smpcall1.c
341
342 ifeq ($(KARCH),mips32)
343 GENERIC_SOURCES += test/debug/mips1.c
344 else
345 GENERIC_SOURCES += test/debug/mips1_skip.c
346 endif
347
348 ifeq ($(KARCH),ia64)
349 GENERIC_SOURCES += test/mm/purge1.c
350 else
351 GENERIC_SOURCES += test/mm/purge1_skip.c
352 endif
353
354endif
355
356## Sources where instrumentation is enabled
357#
358
359ifeq ($(CONFIG_TRACE),y)
360 INSTRUMENTED_SOURCES = \
361 generic/src/adt/btree.c \
362 generic/src/cpu/cpu.c \
363 generic/src/ddi/ddi.c \
364 generic/src/interrupt/interrupt.c \
365 generic/src/main/main.c \
366 generic/src/main/kinit.c \
367 generic/src/proc/the.c \
368 generic/src/mm/frame.c \
369 generic/src/mm/page.c \
370 generic/src/mm/tlb.c \
371 generic/src/mm/as.c \
372 generic/src/mm/slab.c \
373 generic/src/sysinfo/sysinfo.c \
374 generic/src/console/kconsole.c
375else
376 INSTRUMENTED_SOURCES =
377endif
378
379GENERIC_OBJECTS := $(addsuffix .o,$(basename $(GENERIC_SOURCES)))
380ARCH_OBJECTS := $(addsuffix .o,$(basename $(ARCH_SOURCES)))
381GENARCH_OBJECTS := $(addsuffix .o,$(basename $(GENARCH_SOURCES)))
382
383GENARCH_AUTOGENS_H := $(addsuffix .h,$(basename $(GENARCH_AUTOGENS_AG)))
384GENARCH_AUTOGENS_PROBE_C := $(addsuffix .ag.probe.c,$(basename $(GENARCH_AUTOGENS_AG)))
385GENARCH_AUTOGENS_PROBE_S := $(addsuffix .ag.probe.s,$(basename $(GENARCH_AUTOGENS_AG)))
386
387ARCH_AUTOGENS_H := $(addsuffix .h,$(basename $(ARCH_AUTOGENS_AG)))
388ARCH_AUTOGENS_PROBE_C := $(addsuffix .ag.probe.c,$(basename $(ARCH_AUTOGENS_AG)))
389ARCH_AUTOGENS_PROBE_S := $(addsuffix .ag.probe.s,$(basename $(ARCH_AUTOGENS_AG)))
390
391AUTOGENS_H := $(ARCH_AUTOGENS_H) $(GENARCH_AUTOGENS_H)
392AUTOGENS_AG := $(ARCH_AUTOGENS_AG) $(GENARCH_AUTOGENS_AG)
393
394LFLAGS_LTO := $(addprefix -Xlinker ,$(LFLAGS))
395
396ifeq ($(CONFIG_SYMTAB),y)
397 SYMTAB_OBJECTS := generic/src/debug/real_map.o
398else
399 SYMTAB_OBJECTS :=
400endif
401
402$(BIN): $(RAW)
403 $(OBJCOPY) -O $(BFD) $< $@
404
405$(DISASM): $(RAW)
406ifeq ($(CONFIG_LINE_DEBUG),y)
407 $(OBJDUMP) -d -S $< > $@
408else
409 $(OBJDUMP) -d $< > $@
410endif
411
412$(RAW): $(LINK) $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(SYMTAB_OBJECTS)
413ifeq ($(CONFIG_LTO),y)
414 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SYMTAB_OBJECTS)
415else
416 $(LD) $(LFLAGS) -Map $(MAP) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SYMTAB_OBJECTS)
417endif
418ifeq ($(CONFIG_STRIP_BINARIES),y)
419 $(STRIP) $(RAW)
420endif
421
422$(LINK): $(LINK).in $(DEPEND)
423 $(CC) $(DEFS) $(CFLAGS) -D__ASM__ -D__LINKER__ -E -x c $< | grep -v "^\#" > $@
424
425%.h: %.ag
426 $(AUTOGEN) probe $< >$<.probe.c
427 $(CC) $(DEFS) $(CFLAGS) -S -o $<.probe.s $<.probe.c
428 $(AUTOGEN) generate $< <$<.probe.s >$@
429
430%.o: %.S $(DEPEND)
431 $(GCC) $(DEFS) $(GCC_CFLAGS) -D__ASM__ -c -o $@ $<
432ifeq ($(PRECHECK),y)
433 $(JOBFILE) $(JOB) $< $@ as asm/preproc $(DEFS) $(GCC_CFLAGS) -D__ASM__
434endif
435
436%.o: %.s $(DEPEND)
437 $(AS) $(AFLAGS) -o $@ $<
438ifeq ($(PRECHECK),y)
439 $(JOBFILE) $(JOB) $< $@ as asm $(DEFS) $(CFLAGS) $(EXTRA_FLAGS)
440endif
441
442%.o: %.c $(DEPEND)
443 $(CC) $(DEFS) $(CFLAGS) $(EXTRA_FLAGS) $(FPU_NO_CFLAGS) $(if $(findstring $<,$(INSTRUMENTED_SOURCES)),$(INSTRUMENTATION)) -c -o $@ $<
444ifeq ($(PRECHECK),y)
445 $(JOBFILE) $(JOB) $< $@ cc core $(DEFS) $(CFLAGS) $(EXTRA_FLAGS) $(FPU_NO_CFLAGS)
446endif
447
448$(REAL_MAP).o: $(REAL_MAP).bin
449 echo $(SYMTAB_SECTION)" .incbin \"$<\"" | $(AS) $(AFLAGS) -o $@
450
451$(REAL_MAP).bin: $(LINK) $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS)
452 echo $(SYMTAB_SECTION) | $(AS) $(AFLAGS) -o $(EMPTY_MAP)
453ifeq ($(CONFIG_LTO),y)
454 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP_PREV) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(EMPTY_MAP)
455else
456 $(LD) $(LFLAGS) -Map $(MAP_PREV) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(EMPTY_MAP)
457endif
458 $(OBJDUMP) -t $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) > $(DUMP)
459 $(GENMAP) $(MAP_PREV) $(DUMP) $@
460
461 # Do it once again, this time to get correct even the symbols
462 # on architectures that have bss after symtab
463
464 echo $(SYMTAB_SECTION)" .incbin \"$@\"" | $(AS) $(AFLAGS) -o $(SIZEOK_MAP)
465ifeq ($(CONFIG_LTO),y)
466 $(GCC) $(LFLAGS_LTO) -Xlinker -Map -Xlinker $(MAP_PREV) $(DEFS) $(GCC_CFLAGS) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SIZEOK_MAP)
467else
468 $(LD) $(LFLAGS) -Map $(MAP_PREV) -o $@ $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) $(EXTRA_OBJECTS) $(SIZEOK_MAP)
469endif
470 $(OBJDUMP) -t $(ARCH_OBJECTS) $(GENARCH_OBJECTS) $(GENERIC_OBJECTS) > $(DUMP)
471 $(GENMAP) $(MAP_PREV) $(DUMP) $@
472
473$(AUTOGENS_H): $(AGDEPEND)
474
475$(AGDEPEND): $(AUTOGENS_AG)
476 echo "# DO NOT EDIT" >$@
477 for g in $^; do \
478 h=`dirname $$g`/`basename $$g .ag`.h; \
479 for l in `$(AUTOGEN) depend $$g`; do \
480 echo "$$h: $$l" >>$@; \
481 done \
482 done
483
484$(DEPEND): $(COMMON_HEADER_ARCH) $(AUTOGENS_H)
485 makedepend -f - -- $(DEPEND_DEFS) $(CFLAGS) -- $(ARCH_SOURCES) $(GENARCH_SOURCES) $(GENERIC_SOURCES) > $@ 2> /dev/null
486 -[ -f $(DEPEND_PREV) ] && diff -q $(DEPEND_PREV) $@ && mv -f $(DEPEND_PREV) $@
487
488$(COMMON_HEADER_ARCH): $(COMMON_HEADER)
489 ln -sfn ../../../../$< $@
490
491autogen_clean:
492 -rm $(ARCH_AUTOGENS_H) $(ARCH_AUTOGENS_PROBE_C) $(ARCH_AUTOGENS_PROBE_S)
493 -rm $(GENARCH_AUTOGENS_H) $(GENARCH_AUTOGENS_PROBE_C) $(GENARCH_AUTOGENS_PROBE_S)
494 -rm $(AGDEPEND)
Note: See TracBrowser for help on using the repository browser.