#!/usr/bin/perl -w use IO::Socket; use lib '.'; use l3config; use locale; our @Command_Lines; our @Command_Lines_Index; our %Commands_Description; our %Args_Description; our $Mywi_Socket; our %Sessions; # vvv Инициализация переменных выполняется процедурой init_variables our @Day_Name; our @Month_Name; our @Of_Month_Name; our %Search_Machines; our %Elements_Visibility; # ^^^ our %Stat; our %CommandsFDistribution; # Сколько раз в журнале встречается какая команда our $table_number=1; my %mywi_cache_for; # Кэш для экономии обращений к mywi sub make_comment; sub make_new_entries_table; sub load_command_lines_from_xml; sub load_sessions_from_xml; sub sort_command_lines; sub process_command_lines; sub init_variables; sub main; sub collapse_list($); sub print_all; sub print_command_lines; sub print_stat; sub print_header; sub print_footer; main(); sub main { $| = 1; init_variables(); init_config(); open_mywi_socket(); load_command_lines_from_xml($Config{"backend_datafile"}); load_sessions_from_xml($Config{"backend_datafile"}); sort_command_lines; process_command_lines; print_all($Config{"output"}); close_mywi_socket; } # extract_from_cline # In: $what = commands | args # Out: return ссылка на хэш, содержащий результаты разбора # команда => позиция # Разобрать командную строку $_[1] и возвратить хэш, содержащий # номер первого появление команды в строке: # команда => первая позиция sub extract_from_cline { my $what = $_[0]; my $cline = $_[1]; my @lists = split /\;/, $cline; my @command_lines = (); for my $command_list (@lists) { push(@command_lines, split(/\|/, $command_list)); } my %position_of_command; my %position_of_arg; my $i=0; for my $command_line (@command_lines) { $command_line =~ s@^\s*@@; $command_line =~ /\s*(\S+)\s*(.*)/; if ($1 && $1 eq "sudo" ) { $position_of_command{"$1"}=$i++; $command_line =~ s/\s*sudo\s+//; } if ($command_line !~ m@^\s*\S*/etc/@) { $command_line =~ s@^\s*\S+/@@; } $command_line =~ /\s*(\S+)\s*(.*)/; my $command = $1; my $args = $2; if ($command && !defined $position_of_command{"$command"}) { $position_of_command{"$command"}=$i++; }; if ($args) { my @args = split (/\s+/, $args); for my $a (@args) { $position_of_arg{"$a"}=$i++ if !defined $position_of_arg{"$a"}; }; } } if ($what eq "commands") { return \%position_of_command; } else { return \%position_of_arg; } } # # Подпрограммы для работы с mywi # sub open_mywi_socket { $Mywi_Socket = IO::Socket::INET->new( PeerAddr => $Config{mywi_server}, PeerPort => $Config{mywi_port}, Proto => "tcp", Type => SOCK_STREAM); } sub close_mywi_socket { close ($Mywi_Socket) if $Mywi_Socket ; } sub mywi_client { my $query = $_[0]; my $mywi; open_mywi_socket; if ($Mywi_Socket) { local $| = 1; local $/ = ""; print $Mywi_Socket $query."\n"; $mywi = <$Mywi_Socket>; $mywi = "" if $mywi =~ /nothing app/; } close_mywi_socket; return $mywi; } sub make_comment { my $cline = $_[0]; #my $files = $_[1]; my @comments; my @commands = keys %{extract_from_cline("commands", $cline)}; my @args = keys %{extract_from_cline("args", $cline)}; return if (!@commands && !@args); #return "commands=".join(" ",@commands)."; files=".join(" ",@files); # Commands for my $command (@commands) { $command =~ s/'//g; $CommandsFDistribution{$command}++; if (!$Commands_Description{$command}) { $mywi_cache_for{$command} ||= mywi_client ($command) || ""; my $mywi = join ("\n", grep(/\([18]|sh|script\)/, split(/\n/, $mywi_cache_for{$command}))); $mywi =~ s/\s+/ /; if ($mywi !~ /^\s*$/) { $Commands_Description{$command} = $mywi; } else { next; } } push @comments, $Commands_Description{$command}; } return join(" \n", @comments); # Files for my $arg (@args) { $arg =~ s/'//g; if (!$Args_Description{$arg}) { my $mywi; $mywi = mywi_client ($arg); $mywi = join ("\n", grep(/\([5]\)/, split(/\n/, $mywi))); $mywi =~ s/\s+/ /; if ($mywi !~ /^\s*$/) { $Args_Description{$arg} = $mywi; } else { next; } } push @comments, $Args_Description{$arg}; } } =cut Процедура load_command_lines_from_xml выполняет загрузку разобранного lab-скрипта из XML-документа в переменную @Command_Lines # In: $datafile имя файла # Out: @CommandLines загруженные командные строки Предупреждение! Процедура не в состоянии обрабатывать XML-документ любой структуры. В действительности файл cache из которого загружаются данные просто напоминает XML с виду. =cut sub load_command_lines_from_xml { my $datafile = $_[0]; open (CLASS, $datafile) or die "Can't open file of the class ",$datafile,"\n"; local $/; $data = ; close(CLASS); for $command ($data =~ m@(.*?)@sg) { my %cl; while ($command =~ m@<([^>]*?)>(.*?)@sg) { $cl{$1} = $2; } push @Command_Lines, \%cl; } } sub load_sessions_from_xml { my $datafile = $_[0]; open (CLASS, $datafile) or die "Can't open file of the class ",$datafile,"\n"; local $/; my $data = ; close(CLASS); for my $session ($data =~ m@(.*?)@sg) { my %session; while ($session =~ m@<([^>]*?)>(.*?)@sg) { $session{$1} = $2; } $Sessions{$session{local_session_id}} = \%session; } } # sort_command_lines # In: @Command_Lines # Out: @Command_Lies_Index sub sort_command_lines { my @index; for (my $i=0;$i<=$#Command_Lines;$i++) { $index[$i]=$i; } @Command_Lines_Index = sort { $Command_Lines[$index[$a]]->{"time"} <=> $Command_Lines[$index[$b]]->{"time"} } @index; } ################## # process_command_lines # # Обрабатываются командные строки @Command_Lines # Для каждой строки определяется: # class класс # note комментарий # # In: @Command_Lines_Index # In-Out: @Command_Lines sub process_command_lines { for my $i (@Command_Lines_Index) { my $cl = \$Command_Lines[$i]; next if !$cl; $$cl->{err} ||=0; # Класс команды $$cl->{"class"} = $$cl->{"err"} eq 130 ? "interrupted" : $$cl->{"err"} eq 127 ? "mistyped" : $$cl->{"err"} ? "wrong" : "normal"; if ($$cl->{"cline"} =~ /[^|`]\s*sudo/ || $$cl->{"uid"} eq 0) { $$cl->{"class"}.="_root"; } #Обработка пометок # Если несколько пометок (notes) идут подряд, # они все объединяются if ($$cl->{cline}=~ m@cat[^#]*#([\^=v])\s*(.*)@) { my $note_operator = $1; my $note_title = $2; if ($note_operator eq "=") { $$cl->{"class"} = "note"; $$cl->{"note"} = $$cl->{"output"}; $$cl->{"note_title"} = $2; } else { my $j = $i; if ($note_operator eq "^") { $j--; $j-- while ($j >=0 && (!$Command_Lines[$j] || $Command_Lines[$j]->{tty} ne $$cl->{tty})); } elsif ($note_operator eq "v") { $j++; $j++ while ($j <= @Command_Lines && (!$Command_Lines[$j] || $Command_Lines[$j]->{tty} ne $$cl->{tty})); } $Command_Lines[$j]->{note_title}=$note_title; $Command_Lines[$j]->{note}.=$$cl->{output}; $$cl=0; } } elsif ($$cl->{cline}=~ /#([\^=v])(.*)/) { my $note_operator = $1; my $note_text = $2; if ($note_operator eq "=") { $$cl->{"class"} = "note"; $$cl->{"note"} = $note_text; } else { my $j=$i; if ($note_operator eq "^") { $j--; $j-- while ($j >=0 && (!$Command_Lines[$j] || $Command_Lines[$j]->{tty} ne $$cl->{tty})); } elsif ($note_operator eq "v") { $j++; $j++ while ($j <= @Command_Lines && $Command_Lines[$j]->{tty} ne $$cl->{tty} || !$Command_Lines[$j]); } $Command_Lines[$j]->{note}.="$note_text\n"; $$cl=0; } } } } =cut Процедура print_command_lines выводит HTML-представление разобранного lab-скрипта. Разобранный lab-скрипт должен находиться в массиве @Command_Lines =cut sub print_command_lines { my @toc; # Оглавление my $note_number=0; my $result = q(); my $this_day_resut = q(); my $cl; my $last_tty=""; my $last_day=q(); my $last_wday=q(); my $in_range=0; my $current_command=0; my @known_commands; my %filter; if ($Config{filter}) { # Инициализация фильтра for (split /&/,$Config{filter}) { my ($var, $val) = split /=/; $filter{$var} = $val || ""; } } #$result = "Filter=".$Config{filter}."\n"; $Stat{LastCommand} ||= 0; $Stat{TotalCommands} ||= 0; $Stat{ErrorCommands} ||= 0; $Stat{MistypedCommands} ||= 0; my %new_entries_of = ( "1 1" => "программы пользователя", "2 8" => "программы администратора", "3 sh" => "команды интерпретатора", "4 script"=> "скрипты", ); COMMAND_LINE: for my $k (@Command_Lines_Index) { my $cl=$Command_Lines[$Command_Lines_Index[$current_command++]]; next unless $cl; # Пропускаем команды, с одинаковым временем # Это не совсем правильно. # Возможно, что это команды, набираемые с помощью # или запомненные с помощью next if $Stat{LastCommand} == $cl->{time}; # Пропускаем строки, которые противоречат фильтру # Если у нас недостаточно информации о том, подходит строка под фильтр или нет, # мы её выводим #$result .= "before
"; for my $filter_key (keys %filter) { #$result .= "undefined local session id
\n" if !defined($cl->{local_session_id}); #$result .= "undefined filter key $filter_key
\n" if !defined($Sessions{$cl->{local_session_id}}->{$filter_key}); #$result .= $Sessions{$cl->{local_session_id}}->{$filter_key}." != ".$filter{$filter_key}; next COMMAND_LINE if defined($cl->{local_session_id}) && defined($Sessions{$cl->{local_session_id}}->{$filter_key}) && $Sessions{$cl->{local_session_id}}->{$filter_key} ne $filter{$filter_key}; } # Набираем статистику # Хэш %Stat $Stat{FirstCommand} = $cl->{time} unless $Stat{FirstCommand}; if ($cl->{time} - $Stat{LastCommand} < $Config{stat_inactivity_interval}) { $Stat{TotalTime} += $cl->{time} - $Stat{LastCommand} } my $seconds_since_last_command = $cl->{time} - $Stat{LastCommand}; $Stat{LastCommand} = $cl->{time}; $Stat{TotalCommands}++; # Пропускаем строки, выходящие за границу "signature", # при условии, что границы указаны # Пропускаем неправильные/прерванные/другие команды if ($Config{"from"} && $cl->{"cline"} =~ /$Config{"signature"}\s*$Config{"from"}/) { $in_range=1; next; } if ($Config{"to"} && $cl->{"cline"} =~ /$Config{"signature"}\s*$Config{"to"}/) { $in_range=0; next; } next if ($Config{"from"} && $Config{"to"} && !$in_range) || ($Config{"skip_empty"} =~ /^y/i && $cl->{"cline"} =~ /^\s*$/ ) || ($Config{"skip_wrong"} =~ /^y/i && $cl->{"err"} != 0) || ($Config{"skip_interrupted"} =~ /^y/i && $cl->{"err"} == 130); if ($cl->{class} eq "note") { my $note = $cl->{note}; $note = join ("\n", map ("

$_

", split (/-\n/, $note))); $note =~ s@(http:[a-zA-Z.0-9/?\_%-]*)@$1@g; $note =~ s@(www\.[a-zA-Z.0-9/?\_%-]*)@$1@g; $this_day_result .= "" . "

".$cl->{note_title}."

" if $cl->{note_title} . "".$note."

"; if ($cl->{note_title}) { push @{$toc[@toc]},"".$cl->{note_title}.""; $note_number++; } next; } my $output=""; # Выводим верхних строк # и нижних строк, # если эти параметры существуют my @lines = split '\n', $cl->{"output"}; if (($Config{"head_lines"} || $Config{"tail_lines"}) && $#lines > $Config{"head_lines"} + $Config{"tail_lines"} ) { for (my $i=0; $i<= $#lines && $i < $Config{"head_lines"}; $i++) { $output .= $lines[$i]."\n"; } $output .= $Config{"skip_text"}."\n"; my $start_line=$#lines-$Config{"tail_lines"}+1; for ($i=$start_line; $i<= $#lines; $i++) { $output .= $lines[$i]."\n"; } } else { $output .= $cl->{"output"}; } # ## ## Начинается собственно вывод ## # my ($sec,$min,$hour,$day,$mon,$year,$wday,$yday,$isdst) = localtime($cl->{time}); # Добавляем спереди 0 для удобочитаемости $min = "0".$min if $min =~ /^.$/; $hour = "0".$hour if $hour =~ /^.$/; $sec = "0".$sec if $sec =~ /^.$/; $class=$cl->{"class"}; $Stat{ErrorCommands}++ if $class =~ /wrong/; $Stat{MistypedCommands}++ if $class =~ /mistype/; # DAY CHANGE if ( $last_day ne $day) { if ($last_day) { # Вычисляем разность множеств. # Что-то вроде этого, если бы так можно было писать: # @new_commands = keys %CommandsFDistribution - @known_commands; $result .= "

".$Day_Name[$last_wday]."

"; for my $entry_class (sort keys %new_entries_of) { my $new_commands_section = make_new_entries_table($entry_class=~/[0-9]+\s+(.*)/, \@known_commands); my $table_caption = "Таблица ".$table_number++.". ".$Day_Name[$last_wday].". Новые ".$new_entries_of{$entry_class}; if ($new_commands_section) { $result .= "" . "" . "" . $new_commands_section . "
$table_caption
КомандаОписание
" } } @known_commands = keys %CommandsFDistribution; $result .= "\n"; $result .= $this_day_result; $result .= "
"; } push @toc, "".$Day_Name[$wday]."\n"; $last_day=$day; $last_wday=$wday; $this_day_result = q(); } elsif ($seconds_since_last_command > 600) { my $height = $seconds_since_last_command > 1200 ? 100: 60; my $minutes_passed = int($seconds_since_last_command/60); my $minutes_word = $minutes_passed % 100 > 10 && $minutes_passed % 100 < 20 ? "минут" : $minutes_passed % 10 == 1 ? "минута": $minutes_passed % 10 == 0 ? "минут" : $minutes_passed % 10 > 4 ? "минут" : "минуты"; $this_day_result .= "" . "" . "" . "прошло ".$minutes_passed." ".$minutes_word . "" . "\n"; } $this_day_result .= "\n"; # CONSOLE CHANGE if ( $last_tty ne $cl->{"tty"}) { my $tty = $cl->{"tty"}; $this_day_result .= "" ."
" . $tty ."
" .""; $last_tty=$cl->{"tty"}; } # TIME $this_day_result .= $Config{"show_time"} =~ /^y/i ? "$hour:$min:$sec" : ""; # CLASS if ($cl->{"err"}) { $this_day_result .= "" . "
" . "E" . "
" . ""; } else { $this_day_result .= "" . " " . ""; } # COMMAND my $hint = make_comment($cl->{"cline"}); my $cline; $cline = $cl->{"prompt"}.$cl->{"cline"}; $cline =~ s/\n//; $cline = "$cline" if $hint; $cline = "$cline" if !$hint; $this_day_result .= "\n"; $this_day_result .= "
\n" . $cline . "
\n"; # OUTPUT my $last_command = $cl->{"last_command"}; if (!( $Config{"suppress_editors"} =~ /^y/i && grep ($_ eq $last_command, @{$Config{"editors"}}) || $Config{"suppress_pagers"} =~ /^y/i && grep ($_ eq $last_command, @{$Config{"pagers"}}) || $Config{"suppress_terminal"}=~ /^y/i && grep ($_ eq $last_command, @{$Config{"terminal"}}) )) { $this_day_result .= "
" . $output . "
\n"; } # DIFF if ( $Config{"show_diffs"} =~ /^y/i && $cl->{"diff"}) { $this_day_result .= "
"
                    .  $cl->{"diff"}
                    .  "
"; } #NOTES if ( $Config{"show_notes"} =~ /^y/i && $cl->{"note"}) { my $note=$cl->{"note"}; $note =~ s/\n/\n/msg; if (not $note =~ s@(http:[a-zA-Z.0-9/_?%-]*)@$1@g) { $note =~ s@(www\.[a-zA-Z.0-9/_?%-]*)@$1@g; }; # Ширину пока не используем # $this_day_result .= ""; $this_day_result .= "
"; $this_day_result .= "" if $cl->{note_title}; $this_day_result .= ""; $this_day_result .= "
".$cl->{note_title}."
".$note."
\n"; } # COMMENT if ( $Config{"show_comments"} =~ /^y/i) { my $comment = make_comment($cl->{"cline"}); if ($comment) { $this_day_result .= "
" . "" . $comment . "
\n" . "
"; } } # Вывод очередной команды окончен $this_day_result .= "\n"; $this_day_result .= "\n"; } last: { $result .= "

".$Day_Name[$last_wday]."

"; for my $entry_class (keys %new_entries_of) { my $new_commands_section = make_new_entries_table("$entry_class", \@known_commands); @known_commands = keys %CommandsFDistribution; my $table_caption = "Таблица ".$table_number++.". Новые ".$new_entries_of{$entry_class}. ". ".$Day_Name[$last_wday]; if ($new_commands_section) { $result .= "" . "" . "" . $new_commands_section . "
$table_caption
КомандаОписание
" ; } } $result .= "\n"; $result .= $this_day_result; $result .= "
"; } return ($result, collapse_list (\@toc)); } sub make_new_entries_table { my $entries_class = shift; my @known_commands = @{$_[0]}; my %count; my @new_commands = (); for my $c (keys %CommandsFDistribution, @known_commands) { $count{$c}++ } for my $c (keys %CommandsFDistribution) { push @new_commands, $c if $count{$c} != 2; } my $new_commands_section; if (@new_commands){ my $hint; for my $c (reverse sort { $CommandsFDistribution{$a} <=> $CommandsFDistribution{$b} } @new_commands) { $hint = make_comment($c); my ($command, $hint) = $hint =~ m/(.*?) \s*- \s*(.*)/; next unless $command =~ s/\($entries_class\)//i; $new_commands_section .= "$command$hint" if $hint; } } return $new_commands_section; } ############# # print_all # # # # In: $_[0] output_filename # Out: sub print_all { my $output_filename=$_[0]; my $result; my ($command_lines,$toc) = print_command_lines; $result = print_header($toc); $result.= "

Журнал

" . $command_lines; $result.= "

Статистика

" . print_stat; $result.= "

Справка

" . $Html_Help . "
"; $result.= "

О программе

". $Html_About. "
"; $result.= print_footer; if ($output_filename eq "-") { print $result; } else { open(OUT, ">", $output_filename) or die "Can't open $output_filename for writing\n"; print OUT $result; close(OUT); } } ############# # print_header # # # # In: $_[0] Содержание # Out: Распечатанный заголовок sub print_header { my $toc = $_[0]; my $course_name = $Config{"course-name"}; my $course_code = $Config{"course-code"}; my $course_date = $Config{"course-date"}; my $course_center = $Config{"course-center"}; my $course_trainer = $Config{"course-trainer"}; my $course_student = $Config{"course-student"}; my $title = "Журнал лабораторных работ"; $title .= " -- ".$course_student if $course_student; if ($course_date) { $title .= " -- ".$course_date; $title .= $course_code ? "/".$course_code : ""; } else { $title .= " -- ".$course_code if $course_code; } # Управляющая форма my $control_form .= "
Видимые элементы
\n"; for my $element (keys %Elements_Visibility) { my @e = split /\s+/, $element; my $showhide = join "", map { "ShowHide('$_');" } @e ; $control_form .= "". $Elements_Visibility{$element}. "
\n"; } $control_form .= "
\n"; my $result; $result = < $title

Журнал лабораторных работ

HEADER if ( $course_student || $course_trainer || $course_name || $course_code || $course_date || $course_center) { $result .= "

"; $result .= "Выполнил $course_student
" if $course_student; $result .= "Проверил $course_trainer
" if $course_trainer; $result .= "Курс " if $course_name || $course_code || $course_date; $result .= "$course_name " if $course_name; $result .= "($course_code)" if $course_code; $result .= ", $course_date
" if $course_date; $result .= "Учебный центр $course_center
" if $course_center; $result .= "

"; } $result .= <
Содержание
$control_form HEADER return $result; } ############# # print_footer # # # # # sub print_footer { return "\n\n"; } ############# # print_stat # # # # In: # Out: sub print_stat { %StatNames = ( FirstCommand => "Время первой команды журнала", LastCommand => "Время последней команды журнала", TotalCommands => "Количество командных строк в журнале", ErrorsPercentage => "Процент команд с ненулевым кодом завершения, %", MistypesPercentage => "Процент синтаксически неверно набранных команд, %", TotalTime => "Суммарное время работы с терминалом *, час", CommandsPerTime => "Количество командных строк в единицу времени, команда/мин", CommandsFrequency => "Частота использования команд", RareCommands => "Частота использования этих команд < 0.5%", ); @StatOrder = ( FirstCommand, LastCommand, TotalCommands, ErrorsPercentage, MistypesPercentage, TotalTime, CommandsPerTime, CommandsFrequency, RareCommands, ); # Подготовка статистики к выводу # Некоторые значения пересчитываются! # Дальше их лучше уже не использовать!!! my %CommandsFrequency = %CommandsFDistribution; $Stat{TotalTime} ||= 0; my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime($Stat{FirstCommand} || 0); $Stat{FirstCommand} = sprintf "%02i:%02i:%02i %04i-%2i-%2i", $hour, $min, $sec, $year+1900, $mon+1, $mday; ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime($Stat{LastCommand} || 0); $Stat{LastCommand} = sprintf "%02i:%02i:%02i %04i-%2i-%2i", $hour, $min, $sec, $year+1900, $mon+1, $mday; if ($Stat{TotalCommands}) { $Stat{ErrorsPercentage} = sprintf "%5.2f", $Stat{ErrorCommands}*100/$Stat{TotalCommands}; $Stat{MistypesPercentage} = sprintf "%5.2f", $Stat{MistypedCommands}*100/$Stat{TotalCommands}; } $Stat{CommandsPerTime} = sprintf "%5.2f", $Stat{TotalCommands}*60/$Stat{TotalTime} if $Stat{TotalTime}; $Stat{TotalTime} = sprintf "%5.2f", $Stat{TotalTime}/60/60; my $total_commands=0; for $command (keys %CommandsFrequency){ $total_commands += $CommandsFrequency{$command}; } if ($total_commands) { for $command (reverse sort {$CommandsFrequency{$a} <=> $CommandsFrequency{$b}} keys %CommandsFrequency){ my $command_html; my $percentage = sprintf "%5.2f",$CommandsFrequency{$command}*100/$total_commands; if ($percentage < 0.5) { my $hint = make_comment($command); $command_html = "$command"; $command_html = "$command_html" if $hint; $command_html = "$command_html" if not $hint; my $command_html = "$command_html"; $Stat{RareCommands} .= $command_html."".$CommandsFrequency{$command}." , "; } else { my $hint = make_comment($command); $command_html = "$command"; $command_html = "$command_html" if $hint; $command_html = "$command_html" if not $hint; my $command_html = "$command_html"; $percentage = sprintf "%5.2f",$percentage; $Stat{CommandsFrequency} .= "".$command_html."".$CommandsFrequency{$command}."". "|".("="x int($CommandsFrequency{$command}*100/$total_commands))."| $percentage%"; } } $Stat{CommandsFrequency} = "".$Stat{CommandsFrequency}."
"; $Stat{RareCommands} =~ s/, $// if $Stat{RareCommands}; } my $result = q(); for my $stat (@StatOrder) { next unless $Stat{"$stat"}; $result .= "".$StatNames{"$stat"}."".$Stat{"$stat"}."" } $result = "$result
" . "____
*) Интервалы неактивности длительностью " . ($Config{stat_inactivity_interval}/60) . " минут и более не учитываются

"; return $result; } sub collapse_list($) { my $res = ""; for my $elem (@{$_[0]}) { if (ref $elem eq "ARRAY") { $res .= "
    ".collapse_list($elem)."
"; } else { $res .= "
  • ".$elem."
  • "; } } return $res; } sub init_variables { $Html_Help = <
  • В журнал автоматически попадают все команды, данные в любом терминале системы.

  • Для того чтобы убедиться, что журнал на текущем терминале ведётся, и команды записываются, дайте команду w. В поле WHAT, соответствующем текущему терминалу, должна быть указана программа script.

  • Команды, при наборе которых были допущены синтаксические ошибки, выводятся перечёркнутым текстом:
    \$ l s-l
    bash: l: command not found
    

  • Если код завершения команды равен нулю, команда была выполнена без ошибок. Команды, код завершения которых отличен от нуля, выделяются цветом.
    \$ test 5 -lt 4
    Обратите внимание на то, что код завершения команды может быть отличен от нуля не только в тех случаях, когда команда была выполнена с ошибкой. Многие команды используют код завершения, например, для того чтобы показать результаты проверки

  • Команды, ход выполнения которых был прерван пользователем, выделяются цветом.
    \$ find / -name abc
    find: /home/devi-orig/.gnome2: Keine Berechtigung
    find: /home/devi-orig/.gnome2_private: Keine Berechtigung
    find: /home/devi-orig/.nautilus/metafiles: Keine Berechtigung
    find: /home/devi-orig/.metacity: Keine Berechtigung
    find: /home/devi-orig/.inkscape: Keine Berechtigung
    ^C
    

  • Команды, выполненные с привилегиями суперпользователя, выделяются слева красной чертой.
    # id
    uid=0(root) gid=0(root) Gruppen=0(root)
    

  • Изменения, внесённые в текстовый файл с помощью редактора, запоминаются и показываются в журнале в формате ed. Строки, начинающиеся символом "<", удалены, а строки, начинающиеся символом ">" -- добавлены.
    \$ vi ~/.bashrc
    2a3,5
    >    if [ -f /usr/local/etc/bash_completion ]; then
    >         . /usr/local/etc/bash_completion
    >        fi
    

  • Для того чтобы изменить файл в соответствии с показанными в диффшоте изменениями, можно воспользоваться командой patch. Нужно скопировать изменения, запустить программу patch, указав в качестве её аргумента файл, к которому применяются изменения, и всавить скопированный текст:
    \$ patch ~/.bashrc
    В данном случае изменения применяются к файлу ~/.bashrc

  • Для того чтобы получить краткую справочную информацию о команде, нужно подвести к ней мышь. Во всплывающей подсказке появится краткое описание команды.

    Если справочная информация о команде есть, команда выделяется голубым фоном, например: vi. Если справочная информация отсутствует, команда выделяется розовым фоном, например: notepad.exe. Справочная информация может отсутствовать в том случае, если (1) команда введена неверно; (2) если распознавание команды LiLaLo выполнено неверно; (3) если информация о команде неизвестна LiLaLo. Последнее возможно для редких команд.

  • Большие, в особенности многострочные, всплывающие подсказки лучше всего показываются браузерами KDE Konqueror, Apple Safari и Microsoft Internet Explorer. В браузерах Mozilla и Firefox они отображаются не полностью, а вместо перевода строки выводится специальный символ.

  • Время ввода команды, показанное в журнале, соответствует времени начала ввода командной строки, которое равно тому моменту, когда на терминале появилось приглашение интерпретатора

  • Имя терминала, на котором была введена команда, показано в специальном блоке. Этот блок показывается только в том случае, если терминал текущей команды отличается от терминала предыдущей.

  • Вывод не интересующих вас в настоящий момент элементов журнала, таких как время, имя терминала и других, можно отключить. Для этого нужно воспользоваться формой управления журналом вверху страницы.

  • Небольшие комментарии к командам можно вставлять прямо из командной строки. Комментарий вводится прямо в командную строку, после символов #^ или #v. Символы ^ и v показывают направление выбора команды, к которой относится комментарий: ^ - к предыдущей, v - к следующей. Например, если в командной строке было введено:

    \$ whoami
    
    user
    
    \$ #^ Интересно, кто я?
    
    в журнале это будет выглядеть так:
    \$ whoami
    
    user
    
    Интересно, кто я?

  • Если комментарий содержит несколько строк, его можно вставить в журнал следующим образом:

    \$ whoami
    
    user
    
    \$ cat > /dev/null #^ Интересно, кто я?
    
    Программа whoami выводит имя пользователя, под которым 
    мы зарегистрировались в системе.
    -
    Она не может ответить на вопрос о нашем назначении 
    в этом мире.
    
    В журнале это будет выглядеть так:
    \$ whoami
    user
    
    Интересно, кто я?
    Программа whoami выводит имя пользователя, под которым
    мы зарегистрировались в системе.

    Она не может ответить на вопрос о нашем назначении
    в этом мире.
    Для разделения нескольких абзацев между собой используйте символ "-", один в строке.

  • Комментарии, не относящиеся непосредственно ни к какой из команд, добавляются точно таким же способом, только вместо симолов #^ или #v нужно использовать символы #=

  • HELP $Html_About = < LiLaLo (L3) расшифровывается как Live Lab Log.
    Программа разработана для повышения эффективности обучения Unix/Linux-системам.
    (c) Игорь Чубин, 2004-2005

    ABOUT $Html_About.='$Id$

    '; $Html_JavaScript = <0) subelems[j].style.display = "none"; else subelems[j].style.display = ""; } } } } JS %Search_Machines = ( "google" => { "query" => "http://www.google.com/search?q=" , "icon" => "$Config{frontend_google_ico}" }, "freebsd" => { "query" => "http://www.freebsd.org/cgi/man.cgi?query=", "icon" => "$Config{frontend_freebsd_ico}" }, "linux" => { "query" => "http://man.he.net/?topic=", "icon" => "$Config{frontend_linux_ico}"}, "opennet" => { "query" => "http://www.opennet.ru/search.shtml?words=", "icon" => "$Config{frontend_opennet_ico}"}, "local" => { "query" => "http://www.freebsd.org/cgi/man.cgi?query=", "icon" => "$Config{frontend_local_ico}" }, ); %Elements_Visibility = ( "note" => "замечания", "diff" => "редактор", "time" => "время", "ttychange" => "терминал", "wrong_output wrong_cline wrong_root_output wrong_root_cline" => "команды с ошибками", "interrupted_output interrupted_cline interrupted_root_output interrupted_root_cline" => "прерванные команды", "tab_completion_output tab_completion_cline" => "продолжение с помощью tab" ); @Day_Name = qw/ Воскресенье Понедельник Вторник Среда Четверг Пятница Суббота /; @Month_Name = qw/ Январь Февраль Март Апрель Май Июнь Июль Август Сентябрь Октябрь Ноябрь Декабрь /; @Of_Month_Name = qw/ Января Февраля Марта Апреля Мая Июня Июля Августа Сентября Октября Ноября Декабря /; } # Временно удалённый код # Возможно, он не понадобится уже никогда sub search_by { my $sm = shift; my $topic = shift; $topic =~ s/ /+/; return ""; }