Initial commit
This commit is contained in:
commit
3c2c7f64d3
GPG Key ID:
5FD0394ADBD72730
6
README.md
Normal file
6
README.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
# chroot_base
|
||||||
|
|
||||||
|
This is a simple script that makes it easier to run rc.d scripts
|
||||||
|
in a chroot on OpenBSD. To start, put the script into your /etc/rc.d/
|
||||||
|
directory. Then, take a look at the documentation in the script to
|
||||||
|
learn how to use it.
|
||||||
218
chroot_base
Normal file
218
chroot_base
Normal file
@ -0,0 +1,218 @@
|
|||||||
|
# -*- mode: sh; -*-
|
||||||
|
# vim: ft=sh
|
||||||
|
# This file is intended to be a wrapper to /etc/rc.d/rc.subr
|
||||||
|
# that makes it easy to run software inside of chroot jails.
|
||||||
|
# It handles the copying of programs by automatically detecting
|
||||||
|
# and installing required shared libraries.
|
||||||
|
#
|
||||||
|
# NOTE: This file sources /etc/rc.d/rc.subr! DO NOT source it yourself.
|
||||||
|
#
|
||||||
|
# To use this file, simply include it as
|
||||||
|
# . /etc/rc.d/chroot_base
|
||||||
|
# Then, use the provided functions in rc_pre and rc_post to
|
||||||
|
# set up the chroot jail.
|
||||||
|
#
|
||||||
|
# The following variables MUST be defined BEFORE sourcing this file:
|
||||||
|
# chroot_exec - program to run inside chroot jail
|
||||||
|
# chroot_user - user to drop permissions to inside of chroot
|
||||||
|
# chroot_group - group to drop permissions to inside of chroot
|
||||||
|
# chroot_root - path of chroot jail. Should be owned by root:wheel
|
||||||
|
# and writable only by root
|
||||||
|
#
|
||||||
|
# The following variables MAY be defined BEFORE sourcing this file:
|
||||||
|
# chroot_home - if set, the value of $HOME is set to this before the program is started
|
||||||
|
# chroot_bin - if set, programs will be coppied here instead of to /bin. See chroot_env_exec
|
||||||
|
# for information about adding this to $PATH
|
||||||
|
# chroot_env_exec - if set, will be used as the path to the 'env' program in the chroot. You
|
||||||
|
# must install and remove this program yourself. If this is set and chroot_bin
|
||||||
|
# set, chroot bin will be added to PATH
|
||||||
|
# chroot_lib - if set, libraries will be coppied here instead of /usr/lib and it will be added
|
||||||
|
# to $LD_LIBRARY_PATH
|
||||||
|
# chroot_no_ldso - if set to YES, this script will not touch ld.so in the jail
|
||||||
|
# chroot_no_vars - if set to YES, this script will not set any of the daemon* variables or pexp.
|
||||||
|
# In addition, you may ignore all the variables except chroot_root
|
||||||
|
#
|
||||||
|
# The following function are defined by this script:
|
||||||
|
# chroot_install - copy files to the chroot
|
||||||
|
# chroot_install_program - copy a program and all of its libraries into the chroot
|
||||||
|
# chroot_rm - delete files from the chroot
|
||||||
|
# chroot_rm_program - delete a program from the chroot along with all of its libraries
|
||||||
|
# chroot_mkdev - create device files in the chroot's /dev
|
||||||
|
# chroot_mknull - create /dev/null in the chroot
|
||||||
|
|
||||||
|
# Internal variables used by functions
|
||||||
|
_chroot_root_dir="${chroot_root%/}/"
|
||||||
|
if [ -z "${chroot_home}" ]; then
|
||||||
|
_chroot_user_home="$(grep "${chroot_user}" /etc/passwd | cut -d ":" -f6)"
|
||||||
|
else
|
||||||
|
_chroot_user_home="${chroot_home}"
|
||||||
|
fi
|
||||||
|
if [ -z "${chroot_bin}" ]; then
|
||||||
|
_chroot_bin_dir="${_chroot_root_dir}bin/"
|
||||||
|
_chroot_env_path="PATH='$(getconf PATH)'"
|
||||||
|
else
|
||||||
|
chroot_bin="${chroot_bin%/}"
|
||||||
|
_chroot_bin_dir="${_chroot_root_dir}${chroot_bin#/}/"
|
||||||
|
_chroot_env_path="PATH='${chroot_bin}:$(getconf PATH)'"
|
||||||
|
fi
|
||||||
|
if [ -z "${chroot_lib}" ]; then
|
||||||
|
_chroot_lib_dir="${_chroot_root_dir}usr/lib/"
|
||||||
|
else
|
||||||
|
chroot_lib="${chroot_lib%/}"
|
||||||
|
_chroot_lib_dir="${_chroot_root_dir}${chroot_lib#/}/"
|
||||||
|
_chroot_env_ld="LD_LIBRARY_PATH='${chroot_lib}'"
|
||||||
|
fi
|
||||||
|
_chroot_chroot_cmd="/usr/sbin/chroot -u '${chroot_user}' -g '${chroot_user}' '${chroot_root}'"
|
||||||
|
|
||||||
|
# find our env command
|
||||||
|
if [ -z "${chroot_env_exec}" ]; then
|
||||||
|
# There is no env inside the chroot, therefore we run it before chroot
|
||||||
|
# However, this means we cannon env PATH because the chroot resets it
|
||||||
|
_chroot_env_cmd="/usr/bin/env HOME='${_chroot_user_home}' ${_chroot_env_ld}"
|
||||||
|
else
|
||||||
|
# The user has put env inside the chroot
|
||||||
|
# Run it inside, allowing us to set path
|
||||||
|
_chroot_inside_env_cmd="${chroot_env_exec} HOME='${_chroot_user_home}' ${_chroot_env_ld} ${_chroot_env_path}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Set normal rc.subr variables from chroot_* variables
|
||||||
|
if [ "${chroot_no_vars}" != "YES" ]; then
|
||||||
|
daemon_user="root"
|
||||||
|
daemon="${_chroot_env_cmd} ${_chroot_chroot_cmd} ${_chroot_inside_env_cmd} ${chroot_exec}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Source rc.subr
|
||||||
|
. /etc/rc.d/rc.subr
|
||||||
|
|
||||||
|
# Fix the pexp for the chroot
|
||||||
|
if [ "${chroot_no_vars}" != "YES" ]; then
|
||||||
|
pexp="$(eval echo ${chroot_exec}${daemon_flags:+ ${daemon_flags}})"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# usage: chroot_install [files ...]
|
||||||
|
# Copy files into the chroot. Permissions, owner, group, and flags are preserved.
|
||||||
|
function chroot_install {
|
||||||
|
for file in ${@}; do
|
||||||
|
local rel_file
|
||||||
|
if echo "${file}" | grep -E '^/' >/dev/null; then
|
||||||
|
rel_file="$(echo "${file}" | cut -c '2-')" # remove leading /
|
||||||
|
else
|
||||||
|
rel_file="${file}"
|
||||||
|
fi
|
||||||
|
local dir="$(dirname "${rel_file}")"
|
||||||
|
if ! [ -d "${_chroot_root_dir}${dir}" ]; then
|
||||||
|
mkdir -p "${_chroot_root_dir}${dir}"
|
||||||
|
echo "Created '${_chroot_root_dir}${dir}'"
|
||||||
|
fi
|
||||||
|
cp -Rp "${file}" "${_chroot_root_dir}${rel_file}"
|
||||||
|
echo "Installed '${file}' to '${_chroot_root_dir}${rel_file}'"
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# usage: chroot_install_program <file> [name]
|
||||||
|
# Install the program FILE and all of its shared library dependencies
|
||||||
|
# to the chroot. Dependencies are found with ldd. If NAME is provided,
|
||||||
|
# the program will be coppied as NAME.
|
||||||
|
#
|
||||||
|
# NOTE: By default, the program is installed to /bin in the chroot
|
||||||
|
function chroot_install_program {
|
||||||
|
echo "Installing dependencies for '${1}':"
|
||||||
|
for dep in $(ldd "${1}" | tail -n '+4' | grep -Eo '/.+$'); do
|
||||||
|
if [ "${dep}" == "/usr/libexec/ld.so" ]; then
|
||||||
|
if [ "${chroot_no_ldso}" != "YES" ]; then
|
||||||
|
if ! [ -d "${_chroot_root_dir}usr/libexec" ]; then
|
||||||
|
mkdir -p "${_chroot_root_dir}usr/libexec"
|
||||||
|
echo " - Created '${_chroot_root_dir}usr/libexec'"
|
||||||
|
fi
|
||||||
|
install -o root -g bin -m 0444 "${dep}" "${_chroot_root_dir}usr/libexec/ld.so"
|
||||||
|
echo " - Installed '${dep}' to '${_chroot_root_dir}usr/libexec/ld.so'"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
if ! [ -d "${_chroot_lib_dir}" ]; then
|
||||||
|
mkdir -p "${_chroot_lib_dir}"
|
||||||
|
echo " - Created '${_chroot_lib_dir}'"
|
||||||
|
fi
|
||||||
|
local name="$(basename "${dep}")"
|
||||||
|
install -o root -g bin -m 0444 "${dep}" "${_chroot_lib_dir}${name}"
|
||||||
|
echo " - Installed '${dep}' to '${_chroot_lib_dir}${name}'"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
if ! [ -d "${_chroot_bin_dir}" ]; then
|
||||||
|
mkdir -p "${_chroot_bin_dir}"
|
||||||
|
echo "Created '${_chroot_bin_dir}'"
|
||||||
|
fi
|
||||||
|
local name
|
||||||
|
if [ -z "${2}" ]; then
|
||||||
|
name="$(basename "${1}")"
|
||||||
|
else
|
||||||
|
name="${2}"
|
||||||
|
fi
|
||||||
|
install -o root -g bin -m 0755 "${1}" "${_chroot_bin_dir}${name}"
|
||||||
|
echo "Installed '${1}' to '${_chroot_bin_dir}${name}'"
|
||||||
|
}
|
||||||
|
|
||||||
|
# usage: chroot_rm_program <file>
|
||||||
|
# Find all libraries of program with ldd and delete them.
|
||||||
|
# Then, delete the program FILE from /bin of the chroot.
|
||||||
|
#
|
||||||
|
# EXAMPLE:
|
||||||
|
# The usage
|
||||||
|
# chroot_rm_program "/usr/local/bin/git"
|
||||||
|
# would run ldd on /bin/git in the chroot and delete all the
|
||||||
|
# resulting libraries. It would then remove /bin/git from the
|
||||||
|
# chroot.
|
||||||
|
function chroot_rm_program {
|
||||||
|
local name="$(basename "${1}")"
|
||||||
|
local path="${_chroot_bin_dir}${name}"
|
||||||
|
echo "Deleting dependencies for '${1}'"
|
||||||
|
for dep in $(ldd "${path}" | tail -n '+4' | grep -Eo '/.+$'); do
|
||||||
|
if [ "${dep}" == "/usr/libexec/ld.so" ]; then
|
||||||
|
if [ "${chroot_no_ldso}" != "YES" ]; then
|
||||||
|
rm -f "${_chroot_root_dir}usr/libexec/ld.so"
|
||||||
|
echo " - Deleted '${_chroot_root_dir}usr/libexec/ld.so'"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
local name="$(basename "${dep}")"
|
||||||
|
rm -f "${_chroot_lib_dir}${name}"
|
||||||
|
echo " - Deleted '${_chroot_lib_dir}${name}'"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
rm -f "${path}"
|
||||||
|
echo "Deleted '${path}'"
|
||||||
|
}
|
||||||
|
|
||||||
|
# usage: chroot_rm [files ...]
|
||||||
|
# Remove files from the chroot
|
||||||
|
function chroot_rm {
|
||||||
|
for file in ${@}; do
|
||||||
|
if echo "${file}" | grep -E '^/' >/dev/null; then
|
||||||
|
file="$(echo "${file}" | cut -c '2-')" # remove leading /
|
||||||
|
fi
|
||||||
|
rm -rf "${_chroot_root_dir}${file}"
|
||||||
|
echo "Deleted '${_chroot_root_dir}${file}'"
|
||||||
|
done
|
||||||
|
}
|
||||||
|
|
||||||
|
# usage: chroot_mkdev [names ...]
|
||||||
|
# Runs /dev/MAKEDEV with NAMES as the argument in the chroot's
|
||||||
|
# /dev directory
|
||||||
|
function chroot_mkdev {
|
||||||
|
if ! [ -d "${_chroot_root_dir}dev" ]; then
|
||||||
|
mkdir "${_chroot_root_dir}dev"
|
||||||
|
echo "Created '${_chroot_root_dir}dev'"
|
||||||
|
fi
|
||||||
|
(cd "${_chroot_root_dir}dev" && /dev/MAKEDEV "$@")
|
||||||
|
echo "Created device files for '$@' in '${_chroot_root_dir}dev'"
|
||||||
|
}
|
||||||
|
|
||||||
|
# usage: chroot_mknull
|
||||||
|
# This is a convinience function that creates /dev/null in the
|
||||||
|
# chroot.
|
||||||
|
function chroot_mknull {
|
||||||
|
if ! [ -d "${_chroot_root_dir}dev" ]; then
|
||||||
|
mkdir "${_chroot_root_dir}dev"
|
||||||
|
echo "Created '${_chroot_root_dir}dev'"
|
||||||
|
fi
|
||||||
|
mknod -m 0666 "${_chroot_root_dir}dev/null" c 2 2
|
||||||
|
echo "Created /dev/null as '${_chroot_root_dir}dev/null'"
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user