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

FreeBSD Manual Pages

  
 
  

home | help
CHICKEN-INSTALL(1)	    General Commands Manual	    CHICKEN-INSTALL(1)

NAME
       chicken-install -- download and install extension libraries for CHICKEN
       Scheme

SYNOPSIS
       chicken-install [OPTION ...] [NAME[:VERSION] ...]

DESCRIPTION
       chicken-install	downloads,  compiles and installs a prepackaged	exten-
       sion library from sources.  If no extension name	is given on  the  com-
       mand  line, then	any existing egg descriptions in the current directory
       will be executed	in unspecified order.

       The program accepts following arguments:

       -h, -help
	       Show usage and exit.

       -version
	       Show version and	exit.

       -v, -verbose
	       Print extra information during installation.

       -force  Install without confirmation, even if versions don't match.

       -k, -keep
	       Keep temporary files.

       -s, -sudo
	       Use an external program to elevate  privileges  for  filesystem
	       operations.   The  program defaults to sudo(8) but can be over-
	       ridden with the SUDO environment	variable.

       -r, -retrieve
	       Just retrieve the egg, don't install it (giving	-r  more  than
	       once implies -recursive).

       -recursive
	       If -retrieve is given, also fetch dependencies recursively.

       -dry-run
	       Do not build or install,	just print the locations of the	gener-
	       ated build & install scripts.

       -list-versions
	       List available versions for the given eggs.

       -purge  Remove cached files for given eggs (or purge cache completely).

       -host   When cross-compiling, only compile extensions for host.

       -target
	       When cross-compiling, only compile extensions for target.

       -test   Run included test cases,	if available.

       -n, -no-install
	       Do not install the egg, just build it.

       -no-install-dependencies
	       Do  not	install	dependencies. Note that	this option may	result
	       in build	failures due to	missing	extension libraries.

       -u, -update-db
	       Update export database.

       -repository
	       Print path used for egg installation.

       -override filename
	       Override	versions for  installed	 eggs  with  information  from
	       filename.

       -from-list filename
	       Install	eggs  listed in	filename, which	has the	same format as
	       chicken-status(1)'s -list output. This option may be given mul-
	       tiple times.

       -cached
	       Only install eggs from cache, do	not download.

       -l, -location directory
	       Get egg sources from the	given directory.  May be provided mul-
	       tiple times.  Locations specified  on  the  command  line  have
	       precedence over the ones	specified in setup.defaults.

       -feature, -D name
	       Register	 feature  name,	 usable	 as a condition	in cond-expand
	       clauses.

ENVIRONMENT
       Following   environment	 variables    change	the    behaviour    of
       chicken-install:

       CHICKEN_EGG_CACHE	   Location   where  eggs  are	retrieved  and
				   built.

       CHICKEN_INSTALL_PREFIX	   The path prefix for all  target  files,  as
				   given  when	building the system.  Use this
				   variable to override	 where	programs,  in-
				   clude files and additional data files shall
				   be intalled.

       CHICKEN_INSTALL_REPOSITORY  The	path where extension libraries are in-
				   stalled. Defaults to	 the  package  library
				   path	selected during	configuration (usually
				   $prefix/lib/chicken/<binary-version>).
				   Note	that this variable takes precedence to
				   CHICKEN_INSTALL_PREFIX.

       SUDO			   The	command	 to execute when using -s flag
				   in command. If not  provided,  defaults  to
				   sudo(8).

FILES
       $XDG_CONFIG_HOME/chicken/setup.defaults
	     User specific setup.defaults file.	( $XDG_CONFIG_HOME defaults to
	     $HOME/.config )

       $prefix/share/chicken/setup.default
	     System-wide setup.defaults	file.

       $XDG_CACHE_HOME/chicken-install/
	     Default  directory	for cached eggs. ( $XDG_CACHE_HOME defaults to
	     $HOME/.cache )

EXIT STATUS
       The chicken-install utility exits 0 on success, 2 if the	 user  aborted
       an  operation,  3  if it	was invoked with no explicitly given egg names
       and no *.egg files could	be found in the	current	directory, and	>0  if
       any other error occurs.

EXAMPLES
       Install `regex' egg as root user:

	     # chicken-install regex

       Install an egg as an normal user	but using sudo(8):

	     $ chicken-install -s regex

       Install	an egg as an normal user but elevating privileges with differ-
       ent program, such as OpenBSD doas(1):

	     $ SUDO=/usr/bin/doas chicken-install -s regex

SEE ALSO
       chicken(1), chicken-status(1), chicken-uninstall(1), csc(1)

       More  information  can  be  found  in  the   CHICKEN   User's   Manual:
       http://wiki.call-cc.org/manual/index.

AUTHORS
       The CHICKEN Team

BUGS
       Submit bug reports by e-mail to chicken-janitors@nongnu.org

FreeBSD	Ports 14.quarterly	 Apr 26, 2017		    CHICKEN-INSTALL(1)

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

home | help