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

FreeBSD Manual Pages

  
 
  

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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | HISTORY | SEE ALSO

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

home | help