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

FreeBSD Manual Pages

  
 
  

home | help
RINSTALL(1)		     General Commands Manual		     RINSTALL(1)

NAME
     rinstall -- fetch and install scripts from local or http source

SYNOPSIS
     rinstall [-a URL] [-m mode] [-o owner:group] source [target]

DESCRIPTION
     rinstall  is  shipped  to	remote machines by rset(1) to provide a standard
     method of installing files made available over HTTP, or  from  the  current
     working directory for files already staged.

     The  target  must be an absolute path, and is created if it does not exist.
     If the target exists but is not the same as source, then diff(1) is used to
     display the difference before it is updated.  If the target is omitted, the
     source is placed in the staging directory defined	by  the  SD  environment
     variable.

     If  the  source  is defined absolute path it must exist on a file system on
     the remote host.  If the source is  defined  with	a  relative  path,  then
     rinstall first checks if the source already exists in the SD and then tries
     to fetch it from the HTTP resource defined by INSTALL_URL or the -a option.

     rinstall  always checks for a local copy of the source before attempting to
     fetch a  file  from  the  location  defined  by  the  environment	variable
     INSTALL_URL.

     The arguments are as follows:

     -a      URL to an alternative file location.

     -m      Mode  to  set  when  a file is updated.  This argument is passed to
	     chmod(1).

     -o      Owner and/or group to set.  This argument is passed to chown(8).

ENVIRONMENT
     RINSTALL_DIFF_ARGS
	     Arguments for diff(1) tool.  The default is "-U 2".

EXIT STATUS
     The rinstall utility exits with one of the following values:

	   0	   Target file was installed or updated
	   1	   No changes were made
	   2	   Unknown Operating System
	   3	   Unable to fetch requested file

EXAMPLES
     Install configuration file and set permissions

	   $SD/rinstall -m 644 -o www:www resolv.conf /var/www/etc/

     Fetch latest copy of sources and extract

	   $SD/rinstall wodpress.tar.gz
	   tar -xzf $SD/wordpress.tar.gz -C /var/www

     Fetch a file from an alternative location and store it in the  staging  di-
     rectory  under  tools/sys/ if it's not already there and it's not available
     at $INSTALL_URL/tools/sys/sometool.tgz

	   $SD/rinstall 	-a	   https://example.org/files/tool.tar.gz
	   tools/sys/sometool.tgz

FreeBSD ports 15.quarterly	January 17, 2026		     RINSTALL(1)

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

home | help