Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
SHTOOL-ARX.TMP(1)	     GNU Portable Shell Tool	       SHTOOL-ARX.TMP(1)

NAME
     shtool arx - GNU shtool ar(1) extensional command

SYNOPSIS
     shtool arx [-t|--trace] [-C|--command cmd] op archive file [file ...]

DESCRIPTION
     shtool arx is a wrapper around the archiving tool ar(1). It provides the
     ability to create archives out of existing archives, i.e., if one of file
     matches ""*.a"", the archive member files of file are used instead of file
     itself.

     The trick of this command is the automatic handling of archive members
     which is especially interesting if one wants to construct a (usually
     top-level) library archive out of pre-built sub-library archives (usually
     staying inside subdirs) in a large source tree. For GNU libtool based
     projects, a similar functionality is provided by GNU libtool internally,
     too.

OPTIONS
     The following command line options are available.

     -t, --trace
	 Shows the actually involved shell commands.

     -C, --command cmd
	 Set the used ar(1) command to cmd instead of just "ar" (searched in
	 $PATH).

EXAMPLE
      #   Makefile
      AR=ar
      RANLIB=ranlib
	:
      OBJS=foo.o bar.o
      LIBS=baz/libbaz.a quux/libquux.a
	:
      libfoo.a: $(OBJS) $(LIBS)
	  shtool arx -C $(AR) rc libfoo.a $(OBJS) $(LIBS)
	  $(RANLIB) libfoo.a

HISTORY
     The GNU shtool arx command was originally written by Ralf S.  Engelschall
     <rse@engelschall.com> in 1999 for GNU shtool. It was prompted by need to
     build libraries out of sub-libraries inside the OSSP project.

SEE ALSO
     shtool(1), ar(1).

18-Jul-2008			  shtool 2.0.8		       SHTOOL-ARX.TMP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shtool-arx&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help