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

  
 
  

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  extension
     library  from  sources.  If no extension name is given on the command line,
     then any existing egg descriptions in the current directory  will	be  exe-
     cuted 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 opera-
	     tions.   The program defaults to sudo(8) but can be overridden 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 generated
	     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 multiple
	     times.

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

     -l, -location directory
	     Get egg sources from the given directory.	May be provided multiple
	     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, include files and  ad-
				 ditional 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  different
     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.

AUTHORS
     The CHICKEN Team

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

FreeBSD ports 15.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+15.1.quarterly>

home | help