306 lines
13 KiB
Text
306 lines
13 KiB
Text
This is the list of functions used in jhalfs, excluding BLFS tool functions
|
|
and functions defined in {C,H}LFS/master.sh.
|
|
I felt the need for documenting it when trying to add package management.
|
|
Functions are listed in alphabetical order, with a short description and the
|
|
file where they are defined.
|
|
|
|
--------------------------------------------------------------------------
|
|
install_blfs_tools():
|
|
From common/libs/func_install_blfs.
|
|
Description: Copy the needed files to `BLFS_ROOT'. Initialize
|
|
the package tracking. Generates a `configuration' file from
|
|
the tool dependencies settings, and use it to generate
|
|
scriptlets from the blfs book. Uses those scriptlets to download the
|
|
needed tarballs. Then generates a Makefile for building the dependencies.
|
|
Called by: jhalfs
|
|
--------------------------------------------------------------------------
|
|
get_sources():
|
|
From common/libs/func_download_pkgs.
|
|
Description: Downloads packages if `GETPKG' is `y'. Writes package name
|
|
and md5 checksum to `MISSING_FILES.DMP' if a package cannot be found in
|
|
`$SRC_ARCHIVE' and cannot be downloaded, or if md5 checksum does not agree
|
|
book's one. If `MISSING_FILES.DMP' is not empty at the end of the process,
|
|
disable the excution of the makefile.
|
|
Actually, if `$BUILDDIR/sources' does not exist, it is not created if
|
|
`GETPKG' is `n'. And an empty or non existent `$BUILDDIR/sources' is
|
|
not flagged...
|
|
If `GETPKG' is `y', removes `MD5SUMS', `MISSING_FILES.DMP', and `urls.lst'
|
|
from `$BUILDDIR/sources' and generates them in the course of the process.
|
|
Called by: get_book and extract_commands
|
|
--------------------------------------------------------------------------
|
|
gs_wrt_message():
|
|
From common/libs/func_download_pkgs.
|
|
Description: internal function in get_sources. Writes a message to the screen
|
|
and a package name to `MISSING_FILES.DMP'.
|
|
--------------------------------------------------------------------------
|
|
create_urls():
|
|
From common/libs/func_download_pkgs.
|
|
Description: Runs xsltproc with stylesheet urls.xsl on chapter 3 of the
|
|
book. Add BLFS dependencies and custom dependencies if `BLFS_TOOLS' is `y'
|
|
and `CUSTOM_TOOLS' is `y' respectively.
|
|
Called by: get_sources
|
|
--------------------------------------------------------------------------
|
|
wrt_CustomTools_target():
|
|
From common/libs/func_custom_pkgs.
|
|
Description: Add users supplied scripts to `$JHALFSDIR/custom-tools', with
|
|
corresponding entry in the Makefile.
|
|
TODO: Add package management (instructions to user and Makefile entry)
|
|
Called by: All master.sh `build_Makefile'.
|
|
--------------------------------------------------------------------------
|
|
add_CustomToolsURLS():
|
|
From common/libs/func_custom_pkgs.
|
|
Description: Add any users supplied scripts URL information to urls.lst
|
|
Called by: create_urls
|
|
--------------------------------------------------------------------------
|
|
wrt_Makefile_header():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description: Writes the beginning of the Makefile into $MKFILE, which created
|
|
or erased before.
|
|
Called by: All master.sh `build_Makefile'.
|
|
--------------------------------------------------------------------------
|
|
get_package_tarball_name():
|
|
From common/libs/func_wrt_Makefile.
|
|
Arguments: $1 contains the script_name
|
|
Description: Retrieves the tarball name from `pkg_tarball_list' by comparing
|
|
script-name to the beginning of a line in the list. Writes the name found
|
|
to stdout.
|
|
Implements the behavior described in README.CUSTOM, that is, if script_name
|
|
begins with d-, strip that part.
|
|
Called by: various functions in master.sh
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_target():
|
|
From common/libs/func_wrt_Makefile.
|
|
Arguments: $1 contains target name; $2 contains dependency(ies)
|
|
Description: Add lines in the Makefile, which create target and
|
|
initialize log file.
|
|
LUSER version uses $MOUNT_PT in absolute path names.
|
|
Called by: chapter5_Makefiles and chapter6_Makefiles in LFS/master.sh
|
|
and other master.sh
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_target():
|
|
From common/libs/func_wrt_Makefile.
|
|
Arguments: $1 contains target name; $2 contains dependency(ies)
|
|
Description: Add lines in the Makefile, which create target and
|
|
initialize log file.
|
|
CHROOT version uses / in absolute path names.
|
|
Called by: chapter6_Makefiles and chapter78_Makefiles in LFS/master.sh
|
|
and other functions in other master.sh
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_unpack():
|
|
From common/libs/func_wrt_Makefile.
|
|
Arguments: $1 contains tarball name; $2 contains 1 if the existing directory
|
|
is to be presserved.
|
|
Description: Add lines in the Makefile, which unpack and set 'ROOT' var and
|
|
remove existing dir if $2 != 1
|
|
LUSER version uses $MOUNT_PT in absolute path names.
|
|
Uses: Makefile functions remove_existing_dirs, unpack, get_pkg_root.
|
|
--------------------------------------------------------------------------
|
|
CHROOT_Unpack():
|
|
From common/libs/func_wrt_Makefile.
|
|
Arguments: $1 contains tarball name; $2 contains 1 if the existing directory
|
|
is to be presserved.
|
|
Description: Add lines in the Makefile, which unpack and set 'ROOT' var and
|
|
remove existing dir if $2 != 1
|
|
CHROOT version uses / in absolute path names.
|
|
Uses: Makefile functions remove_existing_dirs2, unpack2, get_pkg_root2.
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_test_log():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description: Add lines in the Makefile, which initialize testsuite
|
|
log file.
|
|
LUSER version uses $MOUNT_PT in absolute path names.
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_test_log():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description: Add lines in the Makefile, which initialize testsuite
|
|
log file.
|
|
CHROOT version uses / in absolute path names.
|
|
--------------------------------------------------------------------------
|
|
wrt_RunAsRoot():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description: Some scripts must be run as root..
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_RunAsUser():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description: Calculate time with perl, footer to log file
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_RunAsRoot():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_CopyFstab():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_CopyFstab():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_TouchTimestamp():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_TouchTimestamp():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
LUSER_wrt_LogNewFiles():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_LogNewFiles():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
LUSER_RemoveBuildDirs():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
CHROOT_wrt_RemoveBuildDirs():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_touch():
|
|
From common/libs/func_wrt_Makefile.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_compare_targets():
|
|
From common/libs/func_compare.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_system_build():
|
|
From common/libs/func_compare.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_compare_work():
|
|
From common/libs/func_compare.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_do_ica_work():
|
|
From common/libs/func_compare.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
wrt_logs():
|
|
From common/libs/func_compare.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
validate_config():
|
|
From common/libs/func_validate_configs.sh.
|
|
Description: Are the config values sane (within reason)
|
|
--------------------------------------------------------------------------
|
|
write_error_and_die():
|
|
From common/libs/func_validate_configs.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
validate_file():
|
|
From common/libs/func_validate_configs.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
validate_dir():
|
|
From common/libs/func_validate_configs.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
get_book():
|
|
From common/libs/func_book_parser.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
extract_commands():
|
|
From common/libs/func_book_parser.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
create_package_list():
|
|
From common/libs/func_book_parser.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
check_version():
|
|
From common/libs/func_check_version.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
write_error_and_die():
|
|
From common/libs/func_check_version.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
check_prerequisites():
|
|
From common/libs/func_check_version.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
write_or_exit():
|
|
From common/progress_bar.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
no_empty_builddir():
|
|
From common/common-functions.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
run_make():
|
|
From common/common-functions.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
clean_builddir():
|
|
From common/common-functions.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
process_toolchain():
|
|
From HLFS/master.sh.
|
|
Description: embryo,cocoon and butterfly need special handling
|
|
--------------------------------------------------------------------------
|
|
chapter3_Makefiles():
|
|
From HLFS/master.sh.
|
|
Description: Initialization of the system
|
|
--------------------------------------------------------------------------
|
|
chapter5_Makefiles():
|
|
From HLFS/master.sh.
|
|
Description: Bootstrap or temptools phase
|
|
--------------------------------------------------------------------------
|
|
chapter6_Makefiles():
|
|
From HLFS/master.sh.
|
|
Description: sysroot or chroot build phase
|
|
--------------------------------------------------------------------------
|
|
chapter7_Makefiles():
|
|
From HLFS/master.sh.
|
|
Description: Create a bootable system.. kernel, bootscripts..etc
|
|
--------------------------------------------------------------------------
|
|
build_Makefile():
|
|
From HLFS/master.sh.
|
|
Description: Construct a Makefile from the book scripts
|
|
--------------------------------------------------------------------------
|
|
simple_error():
|
|
From jhalfs.
|
|
Description: Basic error trap.... JUST DIE
|
|
--------------------------------------------------------------------------
|
|
see_ya():
|
|
From jhalfs.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
chapter4_Makefiles():
|
|
From LFS/master.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
chapter5_Makefiles():
|
|
From LFS/master.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
chapter6_Makefiles():
|
|
From LFS/master.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
chapter78_Makefiles():
|
|
From LFS/master.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
build_Makefile():
|
|
From LFS/master.sh.
|
|
Description:
|
|
--------------------------------------------------------------------------
|
|
validate_opt_settings():
|
|
From optimize/optimize_functions.
|
|
Description: Show optimize setting and wait user agreement
|
|
--------------------------------------------------------------------------
|
|
wrt_optimize():
|
|
From optimize/optimize_functions.
|
|
Description: Apply pkg specific opt's to build
|
|
--------------------------------------------------------------------------
|
|
wrt_makeflags():
|
|
From optimize/optimize_functions.
|
|
Description: Apply MAKEFLAGS to build
|
|
--------------------------------------------------------------------------
|