Class: RBT::Linux::LFS

Inherits:
Base show all
Defined in:
lib/rbt/linux/linux_from_scratch/lfs/lfs.rb,
lib/rbt/linux/linux_from_scratch/lfs/run.rb,
lib/rbt/linux/linux_from_scratch/lfs/reset.rb,
lib/rbt/linux/linux_from_scratch/lfs/constants.rb

Overview

RBT::LFS

Constant Summary collapse

T =
#

T

#
true
F =
#

F

#
false
LFS_DIR =
#

LFS_DIR

#
'lfs/'
MOUNT_DIR =
#

MOUNT_DIR

This will become /Mount/lfs/.

#
'/Mount/'+LFS_DIR
SOURCES_DIR =
#

SOURCES_DIR

#
MOUNT_DIR+'sources/'
TOOLS_DIR =
#

TOOLS_DIR

#
MOUNT_DIR+'tools/'
LOCATION_OF_PARTITION =
#

LOCATION_OF_PARTITION

This is presently hardcoded. We may move to a non-hardcoded approach at a later time.

#
'/dev/sdb1'
DEFAULT_USER =
#

DEFAULT_USER

#
:lfs

Constants inherited from RBT::LeanPrototype

RBT::LeanPrototype::ALL_COLOUR_METHODS, RBT::LeanPrototype::ARRAY_KDE_KONSOLE_COLOURS_IN_USE, RBT::LeanPrototype::DAY_NAMES, RBT::LeanPrototype::NAMESPACE, RBT::LeanPrototype::SILENT_REDIRECTION

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Base

#cat, #cd_back_to_the_current_working_directory, #consider_reporting_how_many_programs_are_registered, #cookbook_files?, #copy_recursively, #delete_code_of_conduct?, #determine_appdir_prefix_from_this_input, #directory_validation?, #do_not_show_names, #fast_return_file_size_of_this_program, #file_last_symlinked_program?, #file_programs_version_url, #gem_version, #is_a_64bit_system?, #is_ccache_available?, #is_porg_available?, #is_this_binary_registered?, #is_this_program_included?, #make_command?, #make_install_command?, #new_cookbook_instance_for, #program_exists?, #publish_list_of_all_programs_version, #rcp, registered_binaries?, #remove_symlink, #rename_kde_konsole_tab, #repackage, #report_n_programs, #report_working_directory, #return_compile_time_statistics, #return_n_random_characters, #return_version_of_this_program, #run_make_then_make_install, #sanitize_url1_entry, #set_source_directory, #show_overview_over_available_utility_scripts, #symlink_all_files_from_this_directory_to_that_directory, #system_tags?, #upload_list_of_all_programs_version, #use_yaml_database_for_tags?, #warn_and_exit, #wget

Methods inherited from RBT::LeanPrototype

#a_or_an?, #abbreviations?, #absolute_path, #action, #add_to_the_commandline_arguments, #all_binaries?, #all_files_from, #all_libraries?, #allowed_cookbook_entries?, #appdir_location_of?, #append_onto_the_internal_hash, #append_what_into, #archive_type_of?, #available_programs?, #be_quiet?, #be_verbose?, #begins_with_a_comment?, #capitalize_first_alphabetical_character, #cd_to_the_log_directory, #cd_to_the_temp_directory, #change_directory, #change_permission, #cheering_person?, #chmod, #chop_off_archive, #clear_commandline_arguments, #cliner, #coloured_and_padded_e, #coloured_and_padded_esystem, #coloured_esystem, #colourize_directory_for_system_results, #colourize_this_error, #colourize_this_file_path, #colourize_this_warning, #commandline_arguments?, #commandline_arguments_without_hyphens?, #comment, #convert_dd_mm_yyyy_to_its_long_variant, #convert_env_variable, #copy_directory, #copy_files, #cpr, #create_directory, #current_hour?, #dd_mmm_yyy, #debug, #debug?, #directory_expanded_cookbooks?, #disable_colours, #display_md5sum?, #do_not_debug, #does_the_cookbook_include_this_program?, #does_this_expanded_cookbook_file_exist_for_this_program?, #does_this_file_exist?, #does_this_file_exist_and_is_it_a_file?, #e, #eblue, #ecomment, #ecrimson, #edir, #editor?, #efancy, #eimp, #enable_colours, #enable_debug, #ensure_main_encoding_for, #eparse, #esystem, #esystem_gold, #etomato, #ewarn, #exit_program, #expanded_cookbooks_directory_exists?, #extract_this_archive, #extract_to?, #file_compiled_programs?, #file_dirname_retaining_trailing_slash, #file_predefined_installation_instructions?, #file_specification_of_registered_cookbook_entries, #find_cookbook_alias_for, #find_this_yaml_file, #first_argument?, #first_non_hyphen_argument?, #get_all_directories_from, #get_all_files_from, #get_all_programs, #get_date, #get_extended_date, #get_files_and_directories_from, #go_to_base_dir, #home_dir?, #host_system?, #infer_the_namespace, #internal_hash?, #internal_hash_set_commandline_arguments, #is_an_archive?, #is_directory?, #is_file?, #is_github_url?, #is_make_available?, #is_meson_installed?, #is_on_gobolinux?, #is_on_windows?, #is_roebe?, #is_superuser?, #is_symlink?, #is_this_a_header?, #is_this_a_library?, #is_this_program_included?, #iso_encoding?, #load_dataset_from_this_expanded_cookbook, #load_yaml, #load_yaml_file_from_the_cookbook_directory_for_this_program, #log_directory?, #main_encoding?, #meson_build_file_exists?, #months?, #move_file, #n_programs_are_available?, #n_programs_available?, #namespace?, #no_directory_exists_at, #no_directory_was_found_at, #no_opn, #no_such_file_exists, #open_in_browser, #open_in_editor, #opncomment, #opne, #opnef, #opnerev, #opnerror, #opnesystem, #opnewarn, #opnfancy, #opnn, #otomato, #packages_directory?, #path_to_this_expanded_cookbooks_dataset, #pkgconfig_directory?, #populate_the_internal_hash_with_default_values, #predefined_installation_instructions?, #prepend_this_commandline_argument, #program_version_of?, #project_base_directory?, #project_yaml_directory?, #query_path?, #rarrow?, #read_file, #read_file_in_default_encoding, #read_file_with_default_encoding, #readlines, #readlines_with_proper_encoding, #register_sigint, #registered_cookbook_entries?, #remove, #remove_archive_from_the_end, #remove_comments_from_each_line, #remove_directory, #remove_double_slashes, #remove_file, #remove_newlines, #remove_parens, #remove_symlink, #remove_the_first_commandline_argument, #remove_this_commandline_argument, #remove_this_entry_from_the_commandline_arguments, #remove_trailing_ANSII_escape_code, #remove_unnecessary_data_from_url, #rename, #report_pwd, #require_the_rbt_aliases, #reset_the_internal_hash, #return_all_archives_from_this_directory, #return_appdir_prefix, #return_commandline_arguments_with_leading_hyphens, #return_current_hour_minutes_second, #return_date, #return_day_of_the_month_based_on_utc, #return_full_time, #return_hours_minutes_seconds_based_on_utc, #return_location_to_this_programs_yaml_file, #return_month_based_on_this_number, #return_month_based_on_utc, #return_opnn, #return_program_name, #return_program_name_for_gobolinux_systems, #return_program_name_via_program_information, #return_pwd, #return_unicode_warning_symbol_or_empty_string, #return_utc, #return_utc_time_in_a_format_similar_to_slackware, #return_weekday_based_on_utc, #return_year_based_on_utc, #rev, #rpn, #run_simulation=, #run_simulation?, #sdir, #sdir_return_pwd, #set_be_silent, #set_be_verbose, #set_first_commandline_argument, #set_namespace, #set_use_colours, #set_use_opn, #set_xorg_buffer, #sfancy, #sfile, #silent_redirection?, #silently_create_this_directory_if_it_does_not_yet_exist, #simp, #source_base_directory?, #ssym, #stderr, #store_into_this_directory?, #string_right_arrow?, #swarn, #symlink, #sysbin_directory?, #sysetc_directory?, #sysinclude_directory?, #syslib_directory?, #sysshare_directory?, #system_directory?, #temp_directory?, #to_bool, #to_camelcase, #to_iso_encoding, #to_unicode, #today?, #touch, #try_to_require_beautiful_url, #try_to_require_the_environment_information_gem, #try_to_require_the_extracter_gem, #try_to_require_the_open_gem, #try_to_require_the_xorg_buffer, #try_to_require_wget, #try_to_return_a_special_compile_component, #unicode_cliner, #unicode_middle_cliner, #use_colours=, #use_colours?, #use_opn=, #use_opn?, #utf_encoding?, #verbose_truth, #word_wrap, #write_what_into, #write_what_into_via_unicode, #yes_or_no

Constructor Details

#initialize(run_already = true) ⇒ LFS

#

initialize

#


39
40
41
42
43
44
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 39

def initialize(
    run_already = true
  )
  reset
  run if run_already
end

Class Method Details

.esystem(i) ⇒ Object

#

RBT::LFS.esystem

#


241
242
243
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 241

def self.esystem(i)
  ::RBT.esystem(i)
end

.mkdir(i) ⇒ Object

#

RBT::LFS.mkdir

#


248
249
250
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 248

def self.mkdir(i)
  ::RBT.mkdir(i)
end

.populate_dev_device ⇒ Object

#

RBT::LFS.populate_dev_device

This method can be used to populate the linux /dev entries, as specified in the LFS project.

See the following link for an in-depth explanation:

http://www.linuxfromscratch.org/lfs/view/6.1/chapter06/devices.html
#


263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 263

def self.populate_dev_device
  esystem 'mknod -m 600 /dev/console c 5 1'
  esystem 'mknod -m 666 /dev/null c 1 3'
  esystem 'mount -n -t tmpfs none /dev'
  esystem 'mknod -m 622 /dev/console c 5 1'
  esystem 'mknod -m 666 /dev/null c 1 3'
  esystem 'mknod -m 666 /dev/zero c 1 5'
  esystem 'mknod -m 666 /dev/ptmx c 5 2'
  esystem 'mknod -m 666 /dev/tty c 5 0'
  esystem 'mknod -m 444 /dev/random c 1 8'
  esystem 'mknod -m 444 /dev/urandom c 1 9'
  esystem 'chown 0:tty /dev/{console,ptmx,tty}'
  esystem 'ln -s /proc/self/fd /dev/fd'
  esystem 'ln -s /proc/self/fd/0 /dev/stdin'
  esystem 'ln -s /proc/self/fd/1 /dev/stdout'
  esystem 'ln -s /proc/self/fd/2 /dev/stderr'
  esystem 'ln -s /proc/kcore /dev/core'
  mkdir '/dev/pts'
  mkdir '/dev/shm'
  esystem 'mount -t devpts -o gid=4,mode=620 none /dev/pts'
  esystem 'mount -t tmpfs none /dev/shm'
end

Instance Method Details

#add_user(i = DEFAULT_USER) ⇒ Object

#

add_user

This method will add a new user, in this context the lfs-user.

This is equivalent to this step:

http://www.linuxfromscratch.org/lfs/view/development/chapter04/addinguser.html
#


231
232
233
234
235
236
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 231

def add_user(i = DEFAULT_USER)
  @user = i.to_s
  e 'Next adding a new '+slateblue('user')+' via groupadd/useradd:'
  s 'groupadd '+i.to_s
  s 'useradd -s /bin/bash -g '+i.to_s+' -m -k /dev/null '+i.to_s
end

#compile(name, optional_version = nil) ⇒ Object

#

compile

This will compile. If name contains a number, we split it up.

#


175
176
177
178
179
180
181
182
183
184
185
186
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 175

def compile(
    name, optional_version = nil
  )
  if name =~ /-\d+/
    name = name.split '-'
    optional_version = name[1]
    name = name[0]
  end # from here on everything is fine again.
  installer = RBT::Action::Installer.new(name)
  installer.set_version optional_version if optional_version
  installer.run
end

#consider_creating_mount_directory(i = MOUNT_DIR) ⇒ Object

#

consider_creating_mount_directory

Consider creating the directory /Mount/lfs/.

#


103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 103

def consider_creating_mount_directory(i = MOUNT_DIR)
  unless File.directory? i
    e "Anyway, let's get started and first "+
       sfancy('create a new directory.')
    e i
    mkdir i
    change_permission i
  else
    e 'Directory '+sdir(i)+' already exists, thus'
    e 'we will not create it.'
  end
end

#create_all_directories ⇒ Object

#

create_all_directories

#


200
201
202
203
204
205
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 200

def create_all_directories
  e 'Next creating the '+sdir('source/')+' and '+sdir('tools/')+' directory.'
  create_source_directory
  create_temp_directory
  create_tools_directory # mkdir -v $MOLLI/tools
end

#create_bash_profile ⇒ Object

#

create_bash_profile

#


135
136
137
138
139
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 135

def create_bash_profile # creates ~/.bash_profile
  # what = "exec env -i HOME=$HOME TERM=$TERM PS1='\u:\w\$ ' /bin/bash"
  # to = '~/.bash_profile'
  # append_what_to what, File.expand_path(to)
end

#create_source_directory ⇒ Object

#

create_source_directory

#


210
211
212
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 210

def create_source_directory
  create_directory @mounted_sources_directory,'',true
end

#create_temp_directory ⇒ Object

#

create_temp_directory

#


217
218
219
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 217

def create_temp_directory
  create_directory @mounted_temp_directory,'',true
end

#create_tools_directory ⇒ Object

#

create_tools_directory

#


74
75
76
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 74

def create_tools_directory
  create_directory TOOLS_DIR,'',true
end

#enter_lfs_partition(this_directory = MOUNT_DIR) ⇒ Object

#

enter_lfs_partition

#


94
95
96
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 94

def enter_lfs_partition(this_directory = MOUNT_DIR)
  change_directory this_directory
end

#install_linux_kernel_headers ⇒ Object

#

install_linux_kernel_headers

This is used to install the Linux kernel headers.

URL resource can be found at:

https://www.linuxfromscratch.org/lfs/view/development/chapter05/linux-headers.html
#


126
127
128
129
130
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 126

def install_linux_kernel_headers
  esystem 'make mrproper'
  esystem 'make INSTALL_HDR_PATH=dest headers_install'
  esystem 'cp -rv dest/include/* /tools/include'
end

#mount_lfs_partition ⇒ Object

#

mount_lfs_partition

#


165
166
167
168
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 165

def mount_lfs_partition # mount tag.
  s 'export LFS='+MOUNT_DIR
  s 'mount -v '+LOCATION_OF_PARTITION+' '+MOUNT_DIR
end

#prepare_user_then_login(i = @user) ⇒ Object

#

prepare_user_then_login

#


144
145
146
147
148
149
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 144

def (i = @user)
  s 'chown -v '+i+' '+TOOLS_DIR
  s 'chown -v '+i+' '+MOUNT_DIR+'sources'
  s 'chown -v '+i+' '+MOUNT_DIR+'temp'
  s 'su - '+i
end

#reset ⇒ Object

#

reset

#


16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/reset.rb', line 16

def reset
  super()
  infer_the_namespace
  # ======================================================================= #
  # === @sources_dir
  # ======================================================================= #
  @sources_dir = source_directory?
  # ======================================================================= #
  # === @mounted_sources_directory
  # ======================================================================= #
  @mounted_sources_directory = "#{MOUNT_DIR}sources/"
  # ======================================================================= #
  # === @mounted_temp_directory
  # ======================================================================= #
  @mounted_temp_directory    = MOUNT_DIR+'temp/'
end

#run ⇒ Object

#

run

#


16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/run.rb', line 16

def run
  show_welcome_message              # (1)
  consider_creating_mount_directory # (2)
  # mount_lfs_partition             # (3) optional step
  enter_lfs_partition               # (4)
  create_all_directories            # (5)
  symlink_tools_to_root             # (6)
  set_sticky_bit                    # (7)
  add_user(:lfs)                    # (8) also sets @user.
  
  create_file
  create_bash_profile # creates ~/.bash_profile
e steelblue('DEBUG - all fine up to this point?')
e steelblue('If yes we can continue.')
exit
  compile 'Binutils-2.27' # This should be synced to the most recent Binutils version.
  compile 'GCC-6.3.0'
  install_linux_kernel_headers
  compile 'Glibc-2.14.1'
end

#s(i) ⇒ Object

#

s

Easier wrapper towards system. (system tag)

#


193
194
195
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 193

def s(i)
  esystem(i)
end

#set_sticky_bit(i = @sources_dir) ⇒ Object

#

set_sticky_bit

#


154
155
156
157
158
159
160
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 154

def set_sticky_bit(i = @sources_dir) # Sets the sticky bit.
  begin
    File.chmod(01666, i)
  rescue Exception => error
    pp error
  end
end

#show_welcome_message ⇒ Object

#

show_welcome_message

#


81
82
83
84
85
86
87
88
89
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 81

def show_welcome_message
  e 'Welcome to '+slateblue('Linux from Scratch')+'!'
  e 'This project will make use of the '+
    sfancy('RBT (Ruby Build Tools)')+'project'
  e 'to try and compile a smooth LFS for you from scratch.'
  e
  e 'For this, we will need to know a few things.'
  e
end

#symlink_tools_to_root(i = TOOLS_DIR) ⇒ Object

#

The following is equivalent to:

ln -sv $LFS/tools /
#


54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/rbt/linux/linux_from_scratch/lfs/lfs.rb', line 54

def symlink_tools_to_root(i = TOOLS_DIR) # ln -sv $MOLLI/tools /
  #symlink(TOOLS_DIR, '/')
  symlink_cmd = 'ln -sv '+i+' /'
  _ = '/'+File.basename(i)
  if File.exist? _
    e 'Can not symlink into '+Colours.col(_)+' as that one already exists.'
    e 'We remove it though.'
    remove(_)
    symlink_tools_to_root
  elsif File.exist?(TOOLS_DIR) and File.symlink?(TOOLS_DIR)
    e 'There already exists a symlink at '+gold(TOOLS_DIR)
  else
    e "Now symlinking #{sfancy(i)} to /"
    s symlink_cmd
  end
end