gccmakedep - Unix, Linux Command



NAME

gccmakedep - create dependencies in makefiles using ’gcc -M’

SYNOPSIS

gccmakedep [ b>-sseparator ] [ -fmakefile ] [ -a ] [ -- options -- ] sourcefile ...

DESCRIPTION

The gccmakedep program calls ’gcc -M’ to output makefile rules describing the dependencies of each sourcefile, so that make(1) knows which object files must be recompiled when a dependency has changed.

By default, gccmakedep places its output in the file named makefile if it exists, otherwise Makefile. An alternate makefile may be specified with the -f option. It first searches the makefile for a line beginning with

# DO NOT DELETE

or one provided with the -s option, as a delimiter for the dependency output. If it finds it, it will delete everything following this up to the end of the makefile and put the output after this line. If it doesn’t find it, the program will append the string to the makefile and place the output after that.

EXAMPLE

Normally, gccmakedep will be used in a makefile target so that typing ’make depend’ will bring the dependencies up to date for the makefile. For example,
    SRCS = file1.c file2.c ...
    CFLAGS = -O -DHACK -I../foobar -xyz
    depend:
            gccmakedep -- $(CFLAGS) -- $(SRCS)

OPTIONS

The program will ignore any option that it does not understand, so you may use the same arguments that you would for gcc(1), including -D and -U options to define and undefine symbols and -I to set the include path.
TagDescription
-a Append the dependencies to the file instead of replacing existing dependencies.
-fmakefile
  Filename. This allows you to specify an alternate makefile in which gccmakedep can place its output. Specifying \(lq-\(rq as the file name (that is, -f-) sends the output to standard output instead of modifying an existing file.
-sstring
  Starting string delimiter. This option permits you to specify a different string for gccmakedep to look for in the makefile. The default is \(lq# DO NOT DELETE\(rq.
-- options --
  If gccmakedep encounters a double hyphen (--) in the argument list, then any unrecognized arguments following it will be silently ignored. A second double hyphen terminates this special treatment. In this way, gccmakedep can be made to safely ignore esoteric compiler arguments that might normally be found in a CFLAGS make macro (see the EXAMPLE section above). -D, -I, and -U options appearing between the pair of double hyphens are still processed normally.

EXAMPLES

Normally, gccmakedep will be used in a makefile target so that typing 'make depend' will bring the dependencies up to date for the makefile.

Consider below make file:
SRCS = HelloWorld.c HelloUniverse.c
CFLAGS = -O -DHACK -I../foobar -xyz
depend:
        gccmakedep -- $(CFLAGS) -- $(SRCS)

Executing make depend will update the Makefile as shown below:
$ make depend
gccmakedep -- -O -DHACK -I../foobar -xyz -- HelloWorld.c HelloUniverse.c
SRCS = HelloWorld.c HelloUniverse.c
CFLAGS = -O -DHACK -I../foobar -xyz
depend:
        gccmakedep -- $(CFLAGS) -- $(SRCS)
# DO NOT DELETE
HelloWorld.o: HelloWorld.c /usr/include/stdio.h /usr/include/features.h \
  /usr/include/sys/cdefs.h /usr/include/bits/wordsize.h \
  /usr/include/gnu/stubs.h /usr/include/gnu/stubs-32.h \
  /usr/lib/gcc/i386-redhat-linux/4.1.2/include/stddef.h \
  /usr/include/bits/types.h /usr/include/bits/typesizes.h \
  /usr/include/libio.h /usr/include/_G_config.h /usr/include/wchar.h \
  /usr/include/bits/wchar.h /usr/include/gconv.h \
  /usr/lib/gcc/i386-redhat-linux/4.1.2/include/stdarg.h \
  /usr/include/bits/stdio_lim.h /usr/include/bits/sys_errlist.h
  HelloUniverse.o: HelloUniverse.c /usr/include/stdio.h \
  /usr/include/features.h /usr/include/sys/cdefs.h \
  /usr/include/bits/wordsize.h /usr/include/gnu/stubs.h \
  /usr/include/gnu/stubs-32.h \
  /usr/lib/gcc/i386-redhat-linux/4.1.2/include/stddef.h \
  /usr/include/bits/types.h /usr/include/bits/typesizes.h \
  /usr/include/libio.h /usr/include/_G_config.h /usr/include/wchar.h \
  /usr/include/bits/wchar.h /usr/include/gconv.h \
  /usr/lib/gcc/i386-redhat-linux/4.1.2/include/stdarg.h \
  /usr/include/bits/stdio_lim.h /usr/include/bits/sys_errlist.h \
  /usr/include/stdlib.h /usr/include/sys/types.h /usr/include/time.h \
  /usr/include/endian.h /usr/include/bits/endian.h \
  /usr/include/sys/select.h /usr/include/bits/select.h \
  /usr/include/bits/sigset.h /usr/include/bits/time.h \
  /usr/include/sys/sysmacros.h /usr/include/bits/pthreadtypes.h \
  /usr/include/alloca.h

gccmakedep creates one make rule for each source file containing the object file name for that source file, a colon, and the names of all the included files, including those coming from -include or -imacros command line options.
Advertisements