Ай да Linux Wiki - Вклад участника [ru]

MediaWiki:Deletereason-dropdown

2016-07-31T19:26:06Z

Langator: Новая страница: «* Типовые причины удаления ** Спам ** вандализм ** по запросу автора ** нарушение авторских п…»

* Типовые причины удаления
** Спам
** вандализм
** по запросу автора
** нарушение авторских прав

Создание зашифрованных архивов

2015-12-13T15:10:06Z

Langator: Новая страница: «Иногда бывает нужно зашифровать файлы к консоли. Самый распространённый архиватор tar, са…»

Иногда бывает нужно зашифровать файлы к консоли. Самый распространённый архиватор tar, сам не умеет зашифровавыать архив. Да и графические утилиты разве что могут "запаролить" zip, или rar архив, что на мой взгляд не самый лучший вариант.

Итак. Проще всего с паролем сделать zip архив:
<source lang="bash">zip -e -r test.zip test/</source>
После ввода этой команды, zip дважды спросит пароль для архива, и запакует директорию или нужный файл. Чтобы распаковать запароленный архив можно использовать unzip:

<source lang="bash">unzip -P testpass test.zip</source>

Если не указывать пароль, то unzip спросит его интерактивно.

К сожалению zip лишь просто будет требовать пароль. Никакого шифрования от него ждать не стоит. Поэтому лучше использовать gpg или openssl.

Создание запороленного zip архива пожалуй самое простое. С остальными утилитами, и в частности с tar дело обстоит не так хорошо. Эти программы придерживаются идеологии "делать одну вещь, но делать её хорошо", и у них нет никаких встроенных средств для шифрования, или для "запороливания" архива. Поэтому для того, чтобы получить архив с паролем, надо прибегать к помощи сторонних утилит таких как gpg или openssl, которые ещё и зашифруют содержимое архива.

Чтобы зашифровать архив с помощью gpg:

<source lang="bash">gpg -c test.tar</source>

Gpg спросит пароль и подтверждение пароля. На выходе получим файл - test.tar.gpg. Чтобы распаковать содержимое никакой ключ к gpg не требуется:

<source lang="bash">gpg test.tar.gpg</source>

Кроме того, таким образом не обязательно запаковывать именно архив. Можно просто зашифровать какой либо файл.

И способ с использованием openssl:

<source lang="bash">openssl des3 -salt -in test.tar -out test.tar.des3
enter des-ede3-cbc encryption password:
Verifying - enter des-ede3-cbc encryption password:</source>

Чтобы расшифровать:

<source lang="bash">openssl des3 -d -salt -in test.tar.des3 -out test.tar
enter des-ede3-cbc decryption password:</source>

Запись CD дисков в консоли

2014-06-27T13:55:58Z

Langator: Новая страница: «Зачастую проще воспользоваться консолью для записи CD/DVD дисков, нежели использовать гра…»

Зачастую проще воспользоваться консолью для записи CD/DVD дисков, нежели использовать графические утилиты, а зачастую это единственный вариант. И нет ничего проще! Для этого нам понадобятся: cdrecord и mkisofs. В gentoo они находятся в app-cdr/cdrtools.

Несколько терминов, связанных с форматами файлов:

- Yellow Book: физический формат CD с данными.
- Orange Book: физический формат для записываемых компакт-дисков.
- CD-MO --- магнито-оптические диски.
- CD-WO --- единожды записываемые диски (включают в себя и гибриды наподобие Фото-CD).
- CD-RW --- перезаписываемые диски.
- ISO-9660: Старый стандарт расположения данных, позволяющий использовать только стандарт 8.3 для имен файлов (т.е. 8 символов - имя файла и 3 - расширение).
- Rock Ridge: Расширение ISO-9660, предполагающее использование длинных имен для файлов и UNIX-подобных ссылок. Позволяет сохранить все атрибуты файла, такие как владелец и права доступа. Атрибуты UNIX-файлов при чтении диска в Windows не отображаются.
- Joliet: Расширение ISO-9660, разработанное Microsoft, которое позволяет использовать символы Unicode в именах файлов, так же как и использовать длинные имена файлов. Кроме того, Joliet предоставляет возможность создания урезанных имен для совместимости с MS-DOS, выглядящих наподобие FILENA~1.TXT. Позволяет использовать имена файлов длиной до 64 символов, включая пробелы.
- El Torito: Спецификация для загрузочных компакт-дисков.
- HFS (Hierarchical File System): Оригинальная файловая система компьютеров Macintosh.
- Мультисессия: Позволяет добавлять файлы в любое время, после записи одиночной сессии. Для того, чтобы диски читались, сессия должна быть закрыта. Однако такой подход исключает добавление файлов. Мультисессия позволяет связать отдельные сессии и обновленное содержание диска выглядит как один каталог.
- CD-UDF (Universal Disk Format): файловая система-стандарт пошаговой записи пакетов данных.

Процесс записи выбранных вами файлов состоит из двух этапов. Вначале необходимо создать с помощью mkisofs iso-образ, и потом записать его на диск, используя программу cdrecord. Для создания образа воспользуемся следующим синтаксисом:
<source lang="bash">mkisofs -o test.iso -Jrv -V test_disk /home/usver/test_dir

-o - имя создаваемого iso-файла (test.iso);
-J - используем записи Joliet для совместимости с системой Windows;
-r - Rock Ridge расширение для совсестимости с *nix;
-v - так называемый verbose-режим;
-V - указываем имя тома (test_disk);</source>

Для просмотра содержимого можно смонтировать iso-образ:

<source lang="bash">mount -t iso9660 -o ro,loop=/dev/loop0 test.iso /mnt/iso</source>

Далее нам нужно найти адрес пишещего устройства:

<source lang="bash">cdrecord -scanbus</source>

И записываем диск:
<source lang="bash"> cdrecord -v -eject speed=48 dev=0,0,0 test.iso

-v - verbose-режим. Обозначает тоже, что и в предыдущем случае
-eject - выдвигает лоток привода после окончания процесса записи
-speed - указываем скорость записи диска. В нашем случае - 48х
-dev - записывающее устройство. Числа взяты из вывода программы cdrecord с параметром scanbus
-multi - создания мультисессийного диска</source>

Для очистки CD-RW необходимо в качестве параметров указать следующее:

blank=all - очистить весь диск
blank=disc - то же самое
blank=fast - быстрая очистка диска
blank=session - очистить последнюю сессию
blank=unclose - открыть последнюю записанную сессию

То есть, например команда для быстрой очистки диска будет выглядеть следующим образом:

<source lang="bash">cdrecord dev=0,0,0 blank=fast -eject -speed=4 -v</source>

Для прямого копирования содержимого с одного диска на другой можно воспользоваться командой вида:
<source lang="bash">cdrecord -v dev=0,0,0 speed=4 -isosize /dev/scd1</source>

Но для пущей надежности лучше сначала сделать образ диска:
<source lang="bash">dd if=/dev/scd1 of=/tmp/diskfile.iso</source>

Для того, чтобы добавить еще одну сессию, программе mkisofs необходимо знать номера начального и конечного секторов диска. Узнать это можно следующим образом:
<source lang="bash">cdrecord dev=0,0,0 -msinfo</source>

В результате, команда для создания iso-образа будет иметь следующий вид:
<source lang="bash">mkisofs -o test2.iso -Jr -V Session2 -C 0,27139 -M 0,0,0 /path/to/files</source>

Можно так же эту команду объединить с предыдущей. В итоге, получим следующее:
<source lang="bash">mkisofs -o test2.iso -Jr -V Session2 -C `cdrecord dev=0,0,0 -msinfo` -M 0,0,0 /files/path/</source>

Теперь привод считает информацию о последней записанной сессии и объединит ее содержание с содержанием новой сессии. Предполагается, что последняя сессия записана с опцией '''-multi'''

Заглавная страница

2014-02-17T15:52:40Z

Langator:

Grep

2012-12-04T20:30:00Z

Langator: Откат правок Ipodsoft (обсуждение) к версии Langator

== Введение ==

Команда grep, одна из самых известных и употребительных команд Юниксовидных ОС, ведет свое начало от первого текстового редактора Юникс - ed. В этом редакторе была команда g/re/p (global/regular expression/print), которая и дала свое название новой программе.

Команда grep служит для поиска строк, содержащих заданный пользователем образец.

<source lang="bash">grep ОБРАЗЕЦ имя_файла</source>

Причем обязательным для ввода является только ОБРАЗЕЦ, можно обойтись даже без имени файла (аргумента).

== Команда grep без опций и аргумента. ==

Если не указано имени файла, то команда обрабатывает стандартный ввод, например строки, набранные на клавиатуре:

grep кот

у меня есть кошка,(Enter)
вернее это кот,(Enter)
вернее это кот,
который умеет(Enter)
который умеет
ловить мышей.(Enter)
(Ctrl+c)

В скобках показано, когда я нажимал клавишу Enter, чтобы перейти на новую строку. Одновременно, при нажатии Enter, программа выводила строки, содержащие ОБРАЗЕЦ (кот), отсюда и удвоение этих строк. Видно, что команда реагировала просто на сочетание букв, а не на слово "кот", иначе строка со словом "который" не попала бы в вывод.

Тут мы подошли к очень важному определению строки.
Строкой команда grep (как и все остальные команды Юникс) считает все символы, находящиеся между двумя символами новой строки. Эти невидимые на экране символы возникают в тексте каждый раз, когда пользователь нажимает клавишу Enter. В Юниксовидных системах символ новой строки обозначается обратным слэшем с буквой n (\n). Таким образом, строка может быть любого размера, начиная с одного символа и до многомегабайтного текста. И команда grep честно выведет эту строку, при условии, что она содержит ОБРАЗЕЦ.

== Работа с файлами ==

Команда grep может обрабатывать любое количество файлов одновременно. Создадим три файла:

123.txt: alice.txt: ast.txt:
1234 Алиса очень Символ астериска
5678 красивая девочка, обозначается (*)
89*0 у нее такая ****** звездочкой.
длинная коса!

И дадим команду:

grep '*' 123.txt ast.txt alice.txt

123.txt:89*0
ast.txt:обозначается (*).
alice.txt:у нее такая ******

В выводе перечислены файлы, и указано, в каком из них какая строка содержит символ астериска. ОБРАЗЕЦ (*) пришлось взять в кавычки, чтобы командный интерпретатор понял, что имеется в виду символ, а не условный знак. Попробуйте без кавычек, увидите - ничего не получится.

Команда grep вовсе не ограничена одним выражением в качестве ОБРАЗЦА, можно задавать хоть целые фразы. Только их нужно заключать в кавычки (одинарные или двойные):

grep 'ная ко' 123.txt ast.txt alice.txt
alice.txt:длинная коса!

Возможности поиска при помощи команды grep могут быть значительно расширены применением групповых символов. Например, уже упоминавшийся астериск (звездочка) используется для представления любого символа или группы символов, если речь идет о тексте, и любого файла или группы файлов, если речь идет о директории.

Создадим директорию /example, в которую поместим файлы наших примеров: 123.txt, ast.txt, alice.txt и дадим команду:

grep '*' example/*
example/123.txt:89*0
example/alice.txt:у нее такая ******
example/ast.txt:обозначается (*)

То есть мы приказали просмотреть все файлы директории /example. Таким способом можно обследовать такие огромные директории как /usr, /dev, и любые другие.

== Параметры grep ==

=== Опция -r ===

--recursive

Еще больше увеличит зону поисков опция -r, которая заставит команду grep рекурсивно обследовать все дерево указанной директории, то есть субдиректории, субдиректории субдиректорий, и так далее вплоть до файлов. Например:

grep -r menu /boot

/boot/grub/grub.txt:Highlight the menu entry you want to edit and press 'e', then
/boot/grub/grub.txt:Press the [Esc] key to return to the GRUB menu.
/boot/grub/menu.lst:# GRUB configuration file '/boot/grub/menu.lst'.
/boot/grub/menu.lst:gfxmenu (hd0,3)/boot/message

=== Опция -i ===

--ignore-case

Приказывает команде игнорировать регистр символов, таким образом, поиск будет производиться как среди заглавных, так и среди строчных букв.

=== Опция -c ===

--count

Эта опция не выводит строки, а подсчитывает количество строк, в которых обнаружен ОБРАЗЕЦ. Например:

grep -c root /etc/group
8

То есть в восьми строках файла /etc/group встречается сочетание символов root.

=== Опция -n ===

--line-number

При использовании этой опции вывод команды grep будет указывать номера строк, содержащих ОБРАЗЕЦ:

grep -n print /etc/printcap
1:# /etc/printcap
3:# See "man printcap" for information on editing this file.
5:# In most cases it is better to use a tool to write the printcap
9:# cupsd print daemon at this URL: http://localhost:631

=== Опция -v ===

--invert-match

Выполняет работу, обратную обычной - выводит строки, в которых ОБРАЗЕЦ не встречается:

grep -v print /etc/printcap
#
#
# for you (at least initially), such as apsfilter
# (/usr/share/apsfilter/SETUP, used in conjunction with the
# LPRng lpd daemon), or with the web interface provided by the
# (if you use CUPS).

=== Опция -w ===

--word-regexp

Заставит команду grep искать только строки, содержащие все слово или фразу, составляющую ОБРАЗЕЦ. Например:

grep -w "длинная ко" example/*

Не дает вывода, то есть не находит строк, содержащих выражение "длинная ко". А вот команда:

grep -w "длинная коса" example/*

example/alice.txt:длинная коса!

находит точное соответствие в файле alice.txt.

=== Опция -x ===

--line-regexp

Еще более строгая. Она отберет только те строки исследуемого файла или файлов, которые полностью совпадают с ОБРАЗЦОМ.

grep -x "1234" example/*

example/123.txt:1234

'''''Внимание:''''' Мне попадались (на собственном компьютере) версии grep (например, GNU 2.5), в которых опция -x работала неадекватно. В то же время, другие версии (GNU 2.5.1) работали прекрасно. Если что-то не ладится с этой опцией, попробуйте другую версию, или обновите свою.

=== Опция -l ===

--files-with-matches

Команда grep с этой опцией не возвращает строки, содержащие ОБРАЗЕЦ, но сообщает лишь имена файлов, в которых данный образец найден:

grep -l 'Алиса' example/*

example/alice.txt

Замечу, что сканирование каждого из заданных файлов продолжается только до первого совпадения с ОБРАЗЦОМ.

=== Опция -L ===

--files-without-match

Наоборот, сообщает имена тех файлов, где не встретился ОБРАЗЕЦ:

grep -L 'Алиса' example/*

example/123.txt
example/ast.txt

Как мы имели случай заметить, команда grep, в поисках соответствия ОБРАЗЦУ, просматривает только содержимое файлов, но не их имена. А так часто нужно найти файл по его имени или другим параметрам, например времени модификации! Тут нам придет на помощь простейший программный канал (pipe). При помощи знака программного канала - вертикальной черты (|) мы можем направить вывод команды ls, то есть список файлов в текущей директории, на ввод команды grep, не забыв указать, что мы, собственно, ищем (ОБРАЗЕЦ). Например:

ls | grep grep

grep/
grep-ru.txt

Находясь в директории Desktop, мы "попросили" найти на Рабочем столе все файлы, в названии которых есть выражение "grep". И нашли одну директорию grep/ и текстовой файл grep-ru.txt, который я в данный момент и пишу.

Если мы хотим искать по другим параметрам файла, а не по его имени, то следует применить команду ls -l, которая выводит файлы со всеми параметрами:

ls -l | grep 2008-12-30
-rw-r--r-- 1 ya users 27 2008-12-30 08:06 123.txt
drwxr-xr-x 2 ya users 4096 2008-12-30 08:49 example/
-rw-r--r-- 1 ya users 11931 2008-12-30 14:59 grep-ru.txt

И вот мы получили список всех файлов, модифицированных 30 декабря 2008 года.

Команда grep незаменима при просмотре логов и конфигурационных файлов. Классически примером использования команды grep стал программный канал с командой dmesg. Команда dmesg выводит те самые сообщения ядра, которые мы не успеваем прочесть во время загрузки компьютера. Допустим, мы подключили через USB порт новый принтер, и теперь хотим узнать, как ядро "окрестило" его. Дадим такую команду:

dmesg | grep -i usb

Опция -i необходима, так как usb часто пишется заглавными буквами. Проделайте этот пример самостоятельно - у него длинный вывод, который не укладывается в рамки данной статьи.

== Немного хитростей ==

Если продолжить описание множества опций команды grep, то статья станет утомительной и нечитаемой. Поэтому, рассмотрев необходимый минимум опций, можно развлечься всякими хитростями при применении этой замечательной команды.

=== Хитрость первая ===

Как заставить grep указать в выводе имя файла, где найдено соответствие ОБРАЗЦУ? Например, мы хотим найти строку, содержащую выражение "красивая девочка" в файле alice.txt, да так, чтобы в выводе фигурировало имя файла (для отчета). Если просто дать команду:

grep -w 'красивая девочка' alice.txt
красивая девочка,

То никакого имени файла там не будет. Но стоит добавить в аргументы еще один файл, как все заработает. Обычно, чтобы избежать неожиданностей, указывают файл /dev/null:

grep -w 'красивая девочка' alice.txt /dev/null
alice.txt:красивая девочка,

=== Хитрость вторая ===

Используя "чистые" опции команды grep, мы можем получить все строки, содержащие ОБРАЗЕЦ либо в составе других слов (без опций), либо в виде заданного слова (опция -w). А как найти слова, которые заканчиваются на -ОБРАЗЕЦ или начинаются с ОБРАЗЕЦ-? Для этого существуют специальные значки: \< означает, что ОБРАЗЕЦ будет началом слова, и \>, означающий, что ОБРАЗЕЦ будет концом слова.

grep 'kot' kot.txt
kot
kotoroe
antrekot
kotovasiya
okot
skotobaza
nekotoroe

Это был файл kot.txt целиком.

grep 'kot\>' kot.txt
kot
antrekot
okot

А это были слова, оканчивающиеся на -kot.

grep '\<kot' kot.txt
kot
kotoroe
kotovasiya

Эти начинаются на kot-.

grep '\<kot\>' kot.txt
kot

А вот был "чистый" кот.

Прошу простить за транслитерацию, но с нашими буквами эта хитрость как-то не срабатывает, а с английскими словами не все поймут.

=== Хитрость третья ===

Как быть, если ОБРАЗЕЦ начинается с дефиса, ведь команда примет его за опцию?

Попробуем:

grep '--анонимность' anonim.txt
grep: unrecognized option `--анонимность'

Так и есть - принимает за опцию. Ну так дадим ей опцию -e, которая означает: "Воспринимать ОБРАЗЕЦ только как образец".

grep -e '--анонимность' anonim.txt
--анонимность

Совсем другое дело.

=== Хитрость четвертая ===

Как посмотреть соседние строчки?

grep -C 2 -e '--анонимность' anonim.txt

Требуется соблюсти следующие условия:
--анонимность
--секретность
--неразглашение.

Просмотр вверх и вниз на две строки.

grep -A 1 -e '--анонимность' anonim.txt
--анонимность
--секретность

Просмотр вниз на одну строку.

grep -B 1 -e '--анонимность' anonim.txt

Требуется соблюсти следующие условия:
--анонимность

Просмотр вверх на одну строку.

=== Хитрость пятая ===

grep -r menu /boot

Бинарный файл /boot/grub/stage2 совпадает
Бинарный файл /boot/grub/stage2_eltorito совпадает
/boot/grub/grub.txt:Highlight the menu entry you want to edit and press 'e', then
/boot/grub/grub.txt:Press the [Esc] key to return to the GRUB menu.
/boot/grub/menu.lst:# GRUB configuration file '/boot/grub/menu.lst'.
/boot/grub/menu.lst:gfxmenu (hd0,3)/boot/message

Что означают сообщения в первых двух строках вывода?

Сообщение "Бинарный файл совпадает" ("Binary file matches") появляется, когда совпадение с образцом встречается в бинарных файлах. Если бы grep вывел строки из таких файлов на дисплей, толку было бы немного, а на дисплее могла возникнуть неразбериха (а может быть, и чего похуже, если драйвер терминала воспримет какие-либо фрагменты бинарного файла как команды). Если вы хотите все-таки увидеть эти строки, то применяйте опцию -a или --binary-files=text. Если хотите подавить вывод сообщений "Бинарный файл совпадает", то применяйте опцию -I или --binary-files=without-match.

=== Хитрость шестая ===

Как искать строки, содержащие несколько ОБРАЗЦОВ?

Применить программный канал, канализируя вывод одной команды grep с вводом следующей команды grep.

grep 'у' example/* | grep '*'
example/alice.txt:у нее такая ******

Первый grep ищет у нас "у", а второй - "*" и оба находят искомое в одной строке: "у нее такая ******". Можно сделать эту цепочку команд grep любой длины, было бы чего искать, да строчки достаточно длинные :-)

=== Хитрость седьмая ===

Можно ли искать одновременно в стандартном вводе и в файле?. Можно, если перед именем файла поставить дефис:

echo многие употребляют астериск неправильно | grep 'астериск' - example/*
(стандартный ввод):многие употребляют астериск неправильно
example/ast.txt:Символ астериска

'''''Внимание:''''' Если перед дефисом и после него не будет пробелов, то команда не сработает.

Но настало время вернуться к опциям команды grep.

Пока я занимался хитростями, успел позабыть, какие из опций уже описал, а какие нет. Поэтому я дал команду:

grep 'Опция' grep-ru.txt > option.txt

и получил файл option.txt, в котором перечислены все фигурирующие в файле grep-ru.txt опции.

Общее количество опций программы подавляет, поэтому пойдем по алфавиту, пропуская те, что я уже описал.

Опция -f имя_файла
--file=имя_файла

Весьма полезная опция, когда нужно искать несколько ОБРАЗЦОВ, причем не в одной строке, как мы делали в шестой Хитрости, а в разных. Для того чтобы воспользоваться этой опцией, нужно составить файл, в котором поместить искомые ОБРАЗЦЫ по одному на строчке:

pattern.txt:
nobody
root
ya

А затем дать команду:

grep -f pattern.txt /etc/passwd
nobody:x:65534:65533:nobody:/var/lib/nobody:/bin/bash
root:x:0:0:root:/root:/bin/bash
ya:x:1000:100:alex dmitriev:/home/ya:/bin/bash

'''''Предупреждение:''''' Эта полезная опция, к сожалению, работает не на всех версиях grep. На версии GNU grep 2.5 работает неадекватно, а на GNU grep 2.5.1 - прекрасно. Так что обновляйтесь, господа. Текущая стабильная версия GNU grep - 2.5.3.

=== Опция -o ===

--only-matching

Возвращает не всю строку, где найдено соответствие ОБРАЗЦУ, а только совпадающую с ОБРАЗЦОМ часть строки.

Без опции -o:

$ grep 'английскими' grep-ru.txt

Прошу простить за транслитерацию, но с нашими буквами как-то эта хитрость не срабатывает,
а с английскими словами не все поймут.

А вот с опцией -o:

grep -o 'английскими' grep-ru.txt
английскими

=== Опция -q ===

--quiet --silent

Ничего не выдает на стандартный вывод. В случае нахождения соответствия с ОБРАЗЦОМ немедленно отключается с нулевым статусом. Отключается также при обнаружении ошибки. Для чего это - не знаю. У меня получалось, что программа мгновенно прекращает работу, есть ли совпадения, нет ли, без всяких сообщений, в том числе и о нулевом статусе. Опробовал обе доступные версии grep.

=== Опция -s ===

--no-messages

Подавляет сообщения о несуществующих или нечитаемых файлах.

Предупреждение: традиционные версии последних двух опции (-q и -s) не соответствуют стандарту POSIX.2 и не совпадают с GNU версиями. Поэтому их нельзя применять в скриптах для командной оболочки. Просто перенаправляйте вывод на /dev/null.

== Опции - расширения GNU ==

'''Опции'''
-A --after-context=ЧИСЛО_СТРОК

-B --before-context=ЧИСЛО_СТРОК

-C --context=ЧИСЛО_СТРОК

С этими тремя опциями мы уже познакомились в четвертой Хитрости, они позволяют посмотреть соседние строки. -A: количество строк после совпадения с ОБРАЗЦОМ,

-B: количество строк перед совпадением, и -C: количество строк вокруг совпадения.

Опция --colour[=КОГДА]

Выделяет найденные строки цветом. Значения КОГДА могут быть: never (никогда), always (всегда), или auto. Пример:

grep -o 'английскими' --color grep-ru.txt
английскими

=== Опция -D ДЕЙСТВИЕ ===

--devices=ДЕЙСТВИЕ

Если исследуемый файл является файлом устройства, FIFO (именованным каналом) или сокетом, то следует применять эту опцию. ДЕЙСТВИЙ всего два: read (прочесть), и skip (пропустить). Если вы указываете ДЕЙСТВИЕ read (используется по умолчанию), то программа попытается прочесть специальный файл, как если бы он был обычным файлом; если указываете ДЕЙСТВИЕ skip, то файлы устройств, FIFO и сокеты будут молча проигнорированы.

=== Опция -d ДЕЙСТВИЕ ===

--directories=ДЕЙСТВИЕ

Если входной файл является директорией, то используйте эту опцию. ДЕЙСТВИЕ read (прочесть) попытается прочесть директорию как обычный файл (некоторые ОС и файловые системы запрещают это; тогда появятся соответствующие сообщения, либо директории молча пропустят). Если ДЕЙСТВИЕ skip (пропустить), то директории будут молча проигнорированы. Если ДЕЙСТВИЕ recurse (рекурсивно), то grep будет просматривать все файлы и субдиректории внутри заданного каталога рекурсивно. Это эквивалент опции -r, с которой мы уже познакомились.

=== Опция -H ===

--with-filename

Выдает имя файла для каждого совпадения с ОБРАЗЦОМ. Мы успешно делали это без всяких опций в Хитрости второй.

=== Опция -h ===

--no-filename

Подавляет вывод имен файлов, когда задано несколько файлов для исследования.

=== Опция -I ===

Обрабатывает бинарные файлы как не содержащие совпадений с ОБРАЗЦОМ; эквивалент опции --binary-files=without-match.

=== Опция --include=ОБРАЗЕЦ_имени_файла ===

При рекурсивном исследовании директорий обследовать только файлы, содержащие в своем имени ОБРАЗЕЦ_имени_файла.

=== Опция --exclude=ОБРАЗЕЦ_имени_файла ===

При рекурсивном исследовании директорий пропускать файлы, содержащие в своем имени ОБРАЗЕЦ_имени_файла.

=== Опция -m ЧИСЛО_СТРОК ===

--max-count=ЧИСЛО_СТРОК

Прекратить обработку файла после того, как количество совпадений с ОБРАЗЦОМ достигнет ЧИСЛА_СТРОК:

grep -m 2 'kot' kot.txt
kot
kotoroe

=== Опция -y ===

Синоним опции -i (не различать верхний и нижний регистр символов).

Опции -U и -u применяются только под MS-DOS и MS-Windows, тут нечего о них говорить.

=== Опция --mmap ===

Использует системный вызов mmap вместо системного вызова read. Может дать лучшую производительность, а может привести к ошибкам. Это для продвинутых пользователей.

=== Опция -Z ===

--null

Если в выводе программы имена файлов (например при опции -l), то опция -Z после каждого имени файла выводит нулевой байт вместо символа новой строки (как обычно происходит). Это делает вывод однозначным, даже если имена файлов содержат символы новой строки. Эта опция может быть использована совместно с такими командами как: find -print0, perl -0, sort -z, xargs -0 для обработки файловых имен, составленных необычно, даже содержащих символы новой строки.
(Хотел бы я знать, как можно включить символ новой строки в имя файла. Если кто знает, не поленитесь - сообщите мне.)

=== Опция -z ===

--null-data

Рассматривает ввод как набор строк, каждая из которых заканчивается не символом новой строки, а нулевым байтом. Как и предыдущая опция, используется совместно с вышеперечисленными командами для обработки экзотических имен файлов.

== Команда grep и регулярные выражения ==

Регулярные выражения (Regular Expressions) это система синтаксического разбора текстовых фрагментов по формализованному шаблону, основанная на системе записи ОБРАЗЦОВ для поиска. Проще говоря, регулярное выражение - тот же, уже привычный нам ОБРАЗЕЦ для поиска, только составленный по определенным правилам. Как математические формулы составляются при помощи набора операторов (плюс, минус, степень, корень и прочее), так и регулярные выражения конструируются при помощи различных операторов (?, *, +, {n} и прочие).

Тема регулярных выражений настолько обширна, что требует для своего освещения отдельной статьи; в данной статье мы не будем ее подробно разбирать. Скажу лишь, что существует несколько версий синтаксиса регулярных выражений: Базовый (basic) BRE, Расширенный (extended) ERE и регулярные выражения языка Perl.

=== Опция -G ===

--basic-regexp

Рассматривает ОБРАЗЕЦ как базовое регулярное выражение. Эта опция используется по умолчанию.

=== Опция -E ===

--extended-regexp

Рассматривает ОБРАЗЕЦ как расширенное регулярное выражение.

=== Опция -P ===

--perl-regexp

Рассматривает ОБРАЗЕЦ как регулярное выражение языка Perl.

=== Опция -F ===

--fixed-strings

Рассматривает ОБРАЗЕЦ как список "фиксированных выражений" (fixed strings - термин из области регулярных выражений), разделенных символами новой строки. Будет искать соответствия любому из них.

Кроме того, существуют две альтернативные команды EGREP и FGREP. Обе они соответствуют опциям -E и -F соответственно.

Опции --help и --version (-V) общеизвестны, и я не буду на них останавливаться.

== Команда grep и символы кириллицы. ==

Читая эту статью, вы не могли не заметить, что большинство примеров составлено на русском языке. Я еще не встречал консольных команд, столь хорошо "владеющих русским". Теперь, когда я разобрался с этой командой, то уже не понимаю, как мог обходиться без нее при написании статей (по-русски, разумеется). Лишь некоторые опции "дают прокол" при обработке символов кириллицы.

== Резюме команды grep ==

Команда grep настолько полезна, многофункциональна и проста в употреблении, что, однажды познакомившись с ней, невозможно представить себе работы без нее. Особенно полезна эта команда в качестве фильтра в составе программных каналов (pipes).

== Ссылки ==
[http://open-club.ru/main/reading/HuMan_grep open-club.ru]

[[Категория:Man]]

Блокировка запросов ping и traceroute

2012-09-08T23:03:53Z

Langator: /* Запрет соединений с помощью iptables */

В некотором случае такие утилиты, как ping и traceroute применяются в качестве простого метода для выявления доступных по сети хостов и для определения схемы подключения этих хостов к Internet. Обычно таким способом хакер находит удобные для атаки цели. Блокируя запросы этих утилит, можно удалить свой компьютер из перечня компьютеров, которые будут обнаружены хакером, и предотвратить вероятную атаку.
Рассмотрим пример использования утилиты ping относительно обычного компьютера.

<source lang="bash"> ping -c 1 192.168.1.102

PING 192.168.1.102 (192.168.1.102) from 10.5.5.108 : 56(84) bytes of data.
64 bytes from target.example.com (192.168.1.102): ICMP_seq=0 ttl=255 time=1.140 ms
- – - 192.168.1.102 ping statistics – - -
1 packets transmitted, 1 packets received, 0% packet loss
round-trip min/avg/max/mdev = 1.140/1.140/1.140/0.000 ms</source>

А теперь применим traceroute относительно того же компьютера.

traceroute 192.168.1.102

traceroute to 192.168.1.102 (192.168.1.102), 30 hops max, 38 byte packets
1 hacker-firewall.hack_er.edu (192.163.2.1) 2.892 ms 2.803 ms 2.746 ms
2 hacker-gateway.hack_er.edu (171.678.90.1) 3.881 ms 3.789 ms 3.686 ms
{адреса нескольких промежуточных маршрутизаторов были удалены}
13 veloci.example.com (192.168.1.1) 168.650 ms 183.821 ms 173.287 ms
14 target.example.com (192.168.1.102) 122.819 ms 87.835 ms 104.117 ms

Утилита traceroute отправляет UDP-пакеты с установленным значением поля TTL (время жизни) начиная с 1. В каждом следующем пакете значение поля TTL будет увеличиваться на 1 до тех пор, пока не будут пройдены все маршрутизаторы между отправителем и получателем. Параметр -I сообщает о необходимости использования IСМР-пакетов, как показано ниже.

traceroute -I 192.168.1.102

traceroute to 192.168.1.102 (192.168.1.102), 30 hops max, 38 byte packets
{адреса промежуточных маршрутизаторов тот же, что и в предыдущем листинге}

=== Запрет соединений с помощью iptables ===

Следующая команда iptables позволяет блокировать ping-запросы в виде ICMP-пакетов.

<source lang="bash">/sbin/iptables -A INPUT -s 0/0 -d 192.168.1.102 -р icmp --icmp-type echo-request -j DROP</source>

Параметр -А указывает программе iptables о необходимости добавить правило в набор правил INPUT, в котором определяется способ обработки входящих сообщений. Согласно этой команде, при получении от хоста-отправителя (-s) с любым IP-адресом (0/0) ICMP-запроса (icmp-type echo-request), предназначенного хосту-получателю (-d) с IP-адресом 192.168.1.102 (наш компьютер) и с использованием указанного протокола (-р icmp), следует перейти (-j) к правилу DROP. В результате применения этого правила все поступающие на хост 192.168.1.102 эхо-запросы ICMP, независимо от отправителя, будут отбрасываться.

Теперь попытка установить соединение с хостом 192.168.1.102 посредством команды ping закончится неудачей.

<source lang="bash"> ping -с 5 192.168.1.102

PING 192.168.1.102 (192.168.1.102) from 10.5.5.108 : 56(84) bytes of data
- – - 192.168.1.102 ping statistics – - -
5 packets transmitted, 0 packets received, 100% packet loss
</source>
Для блокирования уделенных запросов с помощью утилиты traceroute добавим правило для отбрасывания всех UDP-пакетов, поступающих на порты в диапазоне от 33435 до 33525.

<source lang="bash">/sbin/iptables -A INPUT -s 0/0 -d 192.168.1.102 -p udp --dport 33435:33525 -j DROP</source>

Обратите внимание на то, как указан диапазон портов (33435 : 33525). При попытке хакером использовать traceroute, он получит следующий результат.

<source lang="bash"> traoaroute 192.168.1.102

traceroute to 192.168.1.102 (192.168.1.102), 30 hops max, 38 byte packets
1 cracker-firewall.crack_er.edu (192.168.2.1) 2.892 ms 2.803 ms 2.746 ms
2 cracker-gateway.crack_er.edu (171.678.90.1) 3.881 ms 3.789 ms 3.686 ms
{пропущены записи о нескольких промежуточных маршрутизаторах}
12 cisco.example.com (254.192.1.20) 158.888 ms 161.422 ms 160.884 ms
13 veloci.example.com (192.168.1.1) 168.650 ms 183.821 ms 173.287 ms
14 * * *
15 * * *</source>

Итак, мы успешно блокировали обмен потенциально опасными пакетами с нашим компьютером. Однако промежуточные хосты на пути доставки пакетов от хоста хакера к нашему хосту по-прежнему отвечают. В идеальном варианте следует настроить все контролируемые хосты на отбрасывание “разведывательных” пакетов.

'''''Внимание:''''' Заблокированные в примере порты являются стандартными портами, которые использует UNIX-утилита traceroute. В других версиях этой программы (например mtr) диапазон используемых портов может быть иным.

== Ссылки ==
[http://securos.org.ua/iptables-pravila-blokirovki-zaprosov-ping-i-traceroute/ securos.org.ua]
[[Категория:Руководства]] [[Категория:Безопасность]] [[Категория:Iptables]]

Резервное копирование и восстановление mediawiki

2012-03-17T02:18:43Z

Langator:

[[Category:Backup]]
[[Category:Script]]
Представлен скрипт для создания резервных копий, восстановления, обновления mediawiki и расширений.
Особенность обновления расширений заключается в том, что контроль версий поддерживается через svn.
<source lang=bash>

#!/bin/bash

ColorOff='\\e[0m' # Text Reset
BWhite='\\e[1;37m' # Bold White
Blue='\e[0;34m'

#Обязательно вставьте свои значения
WIKIPATH="/www/wiki" #директория установки wiki
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" # mysql пользователь
MYSQLHOST="localhost" # Хост mysql
WIKIDB="wikidb" #mysql база wiki

mediawiki=$1
if [ -z $mediawiki ]
then
echo -e " Введите название архива с wiki для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wiki\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewiki <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wiki из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wiki из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo Вы не root
exit 1
fi

dir=`pwd`

case $mediawiki in

backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wiki-wikidb-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wiki folder. Wait..."
nice -n 19 tar -czf $BACKUPPATH/aidalinux-wiki-$(date '+%Y%m%d').tar.gz $WIKIPATH
echo "backup wiki completed"

exit 0
;;
extensions | -e)
for extensions in `ls $WIKIPATH/extensions`
do
cd $WIKIPATH/extensions/"$extensions"
svn update
cd ..
done

exit 0
;;
restorewiki | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wiki" && exit 1

backup_wiki="$2"
echo "restore wiki files"
tar xzvf "$backup_wiki" -C $WIKIPATH --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wiki" && exit 1

wiki_wikidb="$2"
echo "restore datebase"
gunzip -c "$wiki_wikidb" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB
echo "done"
exit 0
;;
esac

#Определение расширения архива с mediawiki
arch=`echo $mediawiki | awk -F. '{ print $NF}'`

if [ "$arch" = gz ]
then
echo "start update mediawiki"
else
echo "Вы ошиблись в вводе аргумента"
exit 1
fi

cd "$dir"

#update mediawiki
tar xzf $mediawiki -C $WIKIPATH --strip-components=1

echo "update database"
php $WIKIPATH/maintenance/update.php
echo "is all!!"
</source>

Резервное копирование и восстановление wordpress

2012-03-17T02:17:27Z

Langator:

[[Category:Backup]]
[[Category:Script]]
Представлен скрипт для создания резервных копий, восстановления и обновления wordpress.
<source lang="bash">
#!/bin/bash
#вставьте свои значения
path="/www/youpath" #Путь до wordpress
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" #mysql юзер
MYSQLHOST="localhost" #хост mysql
WORDPRESSDB="wordpressdb" #база данных wordpress

arg="$1"

if [ -z "$arg" ]
then
echo -e "Введите:
\e[0;34mupgrade\\e[0m или \e[0;34m -u \\e[0m для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wordpress\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewordpress <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wordpress из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wordpress из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo "Вы не root"
exit 1
fi

case $arg in
backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wordpress-db-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wordpress folder. Wait..."
# Для исключения файла или каталога используйте --exclude="./youdir"
# точка обязательна и не ставить слэш в конце имени директории
cd $path; nice -n 19 tar -cvzf $BACKUPPATH/wordpress-$(date '+%Y%m%d').tar.gz . --exclude="./wiki" --exclude="./upload"
echo "backup wordpress completed"

exit 0
;;
restorewordpress | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wordpress" && exit 1

backup_wordpress="$2"
echo "restore wordpress files"
tar xzvf "$backup_wordpress" -C $path --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wordpress" && exit 1

wordpress_db="$2"
echo "restore database"
gunzip -c "$wordpress_db" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB
echo "done"
exit 0
;;
upgrade | -u)
wordpress="$2"
arch=`echo "$wordpress" | awk -F. '{ print $NF}'`
if [ "$arch" = "zip" -o "$arch" = "gz" ]
then
echo "prepare to upgrade"
[ -d $path/upload/ ] || mkdir $path/upload/
cp -v -R $path/wp-content/ $path/wp-config.php $path/.htaccess $path/upload/
rm $path/wp*.php $path/license.txt $path/readme.html $path/xmlrpc.php
rm -rf $path/wp-admin/ $path/wp-includes/
cp $path/upload/wp-config.php $path

echo "update wordpress"

if [ $arch = zip ]
then
unzip -o $wordpress -d $path
elif [ $arch = gz ]
then
tar xzf $wordpress -C $path --strip-components=1
else
exit 1
fi

cp -rf $path/upload/* $path
rm -rf $path/upload

echo "====================================================================================="
echo "==== For update database you need open <yousite>/wp-admin/upgrade.php in browser ===="
echo "====================================================================================="
else
echo "Неизвестный тип архива, автоопределение работает только для zip и tar.gz"
exit 1

fi
esac

echo "is all!!"

exit 0
</source>

Резервное копирование и восстановление wordpress

2012-03-17T01:58:48Z

Langator:

Резервное копирование и восстановление mediawiki

2012-03-17T01:35:00Z

Langator:

[[Category:Backup]]
[[Category:Script]]
Представлен скрипт для создания резервных копий, восстановления, обновления mediawiki и расширений.
Особенность обновления расширений заключается в том, что контроль версий поддерживается через svn.
<source lang=bash>

#!/bin/bash

ColorOff='\\e[0m' # Text Reset
BWhite='\\e[1;37m' # Bold White
Blue='\e[0;34m'

#Обязательно вставьте свои значения
WIKIPATH="/www/wiki" #директория установки wiki
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" # mysql пользователь
MYSQLHOST="localhost" # Хост mysql
WIKIDB="wikidb" #mysql база wiki

mediawiki=$1
if [ -z $mediawiki ]
then
echo -e " Введите название архива с wiki для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wiki\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewiki <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wiki из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wiki из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo Вы не root
exit 1
fi

dir=`pwd`

case $mediawiki in

backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wiki-wikidb-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wiki folder. Wait..."
nice -n 19 tar -czf $BACKUPPATH/aidalinux-wiki-$(date '+%Y%m%d').tar.gz $WIKIPATH
echo "backup wiki completed"

exit 0
;;
extensions | -e)
for extensions in `ls $WIKIPATH/extensions`
do
cd $WIKIPATH/extensions/"$extensions"
svn update
cd ..
done

exit 0
;;
restorewiki | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wiki"; exit 1

backup_wiki="$2"
echo "restore wiki files"
tar xzvf "$backup_wiki" -C $WIKIPATH --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wiki"; exit 1

wiki_wikidb="$2"
echo "restore datebase"
gunzip -c "$wiki_wikidb" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB
echo "done"
exit 0
;;
esac

#Определение расширения архива с mediawiki
arch=`echo $mediawiki | awk -F. '{ print $NF}'`

if [ "$arch" = gz ]
then
echo "start update mediawiki"
else
echo "Вы ошиблись в вводе аргумента"
exit 1
fi

cd "$dir"

#update mediawiki
tar xzf $mediawiki -C $WIKIPATH --strip-components=1

echo "update database"
php $WIKIPATH/maintenance/update.php
echo "is all!!"
</source>

Резервное копирование и восстановление wordpress

2012-03-17T01:34:28Z

Langator:

[[Category:Backup]]
[[Category:Script]]
Представлен скрипт для создания резервных копий, восстановления и обновления wordpress.
<source lang="bash">
#!/bin/bash
#вставьте свои значения
path="/www/youpath" #Путь до wordpress
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" #mysql юзер
MYSQLHOST="localhost" #хост mysql
WORDPRESSDB="wordpressdb" #база данных wordpress

arg="$1"

if [ -z "$arg" ]
then
echo -e "Введите:
\e[0;34mupgrade\\e[0m или \e[0;34m -u \\e[0m для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wordpress\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewordpress <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wordpress из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wordpress из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo "Вы не root"
exit 1
fi

case $arg in
backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wordpress-db-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wordpress folder. Wait..."
# Для исключения файла или каталога используйте --exclude="./youdir"
# точка обязательна и не ставить слэш в конце имени директории
cd $path; nice -n 19 tar -cvzf $BACKUPPATH/wordpress-$(date '+%Y%m%d').tar.gz . --exclude="./wiki" --exclude="./upload"
echo "backup wordpress completed"

exit 0
;;
restorewordpress | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wordpress"; exit 1

backup_wordpress="$2"
echo "restore wordpress files"
tar xzvf "$backup_wordpress" -C $path --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wordpress"; exit 1

wordpress_db="$2"
echo "restore database"
gunzip -c "$wordpress_db" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB
echo "done"
exit 0
;;
upgrade | -u)
wordpress="$2"
arch=`echo "$wordpress" | awk -F. '{ print $NF}'`
if [ "$arch" = "zip" -o "$arch" = "gz" ]
then
echo "prepare to upgrade"
[ -d $path/upload/ ] || mkdir $path/upload/
cp -v -R $path/wp-content/ $path/wp-config.php $path/.htaccess $path/upload/
rm $path/wp*.php $path/license.txt $path/readme.html $path/xmlrpc.php
rm -rf $path/wp-admin/ $path/wp-includes/
cp $path/upload/wp-config.php $path

echo "update wordpress"

if [ $arch = zip ]
then
unzip -o $wordpress -d $path
elif [ $arch = gz ]
then
tar xzf $wordpress -C $path --strip-components=1
else
exit 1
fi

cp -rf $path/upload/* $path
rm -rf $path/upload

echo "====================================================================================="
echo "==== For update database you need open <yousite>/wp-admin/upgrade.php in browser ===="
echo "====================================================================================="
else
echo "Неизвестный тип архива, автоопределение работает только для zip и tar.gz"
exit 1

fi
esac

echo "is all!!"

exit 0
</source>

Резервное копирование и восстановление mediawiki

2012-03-17T01:27:22Z

Langator:

Представлен скрипт для создания резервных копий, восстановления, обновления mediawiki и расширений.
Особенность обновления расширений заключается в том, что контроль версий поддерживается через svn.
<source lang=bash>

#!/bin/bash

ColorOff='\\e[0m' # Text Reset
BWhite='\\e[1;37m' # Bold White
Blue='\e[0;34m'

#Обязательно вставьте свои значения
WIKIPATH="/www/wiki" #директория установки wiki
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" # mysql пользователь
MYSQLHOST="localhost" # Хост mysql
WIKIDB="wikidb" #mysql база wiki

mediawiki=$1
if [ -z $mediawiki ]
then
echo -e " Введите название архива с wiki для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wiki\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewiki <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wiki из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wiki из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo Вы не root
exit 1
fi

dir=`pwd`

case $mediawiki in

backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wiki-wikidb-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wiki folder. Wait..."
nice -n 19 tar -czf $BACKUPPATH/aidalinux-wiki-$(date '+%Y%m%d').tar.gz $WIKIPATH
echo "backup wiki completed"

exit 0
;;
extensions | -e)
for extensions in `ls $WIKIPATH/extensions`
do
cd $WIKIPATH/extensions/"$extensions"
svn update
cd ..
done

exit 0
;;
restorewiki | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wiki"; exit 1

backup_wiki="$2"
echo "restore wiki files"
tar xzvf "$backup_wiki" -C $WIKIPATH --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wiki"; exit 1

wiki_wikidb="$2"
echo "restore datebase"
gunzip -c "$wiki_wikidb" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB
echo "done"
exit 0
;;
esac

#Определение расширения архива с mediawiki
arch=`echo $mediawiki | awk -F. '{ print $NF}'`

if [ "$arch" = gz ]
then
echo "start update mediawiki"
else
echo "Вы ошиблись в вводе аргумента"
exit 1
fi

cd "$dir"

#update mediawiki
tar xzf $mediawiki -C $WIKIPATH --strip-components=1

echo "update database"
php $WIKIPATH/maintenance/update.php
echo "is all!!"
</source>

Резервное копирование и восстановление wordpress

2012-03-17T01:25:16Z

Langator: Новая страница: «Представлен скрипт для создания резервных копий, восстановления и обновления wordpress. <source...»

Представлен скрипт для создания резервных копий, восстановления и обновления wordpress.
<source lang="bash">
#!/bin/bash
#вставьте свои значения
path="/www/youpath" #Путь до wordpress
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" #mysql юзер
MYSQLHOST="localhost" #хост mysql
WORDPRESSDB="wordpressdb" #база данных wordpress

arg="$1"

if [ -z "$arg" ]
then
echo -e "Введите:
\e[0;34mupgrade\\e[0m или \e[0;34m -u \\e[0m для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wordpress\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewordpress <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wordpress из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wordpress из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo "Вы не root"
exit 1
fi

case $arg in
backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wordpress-db-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wordpress folder. Wait..."
# Для исключения файла или каталога используйте --exclude="./youdir"
# точка обязательна и не ставить слэш в конце имени директории
cd $path; nice -n 19 tar -cvzf $BACKUPPATH/wordpress-$(date '+%Y%m%d').tar.gz . --exclude="./wiki" --exclude="./upload"
echo "backup wordpress completed"

exit 0
;;
restorewordpress | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wordpress"; exit 1

backup_wordpress="$2"
echo "restore wordpress files"
tar xzvf "$backup_wordpress" -C $path --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wordpress"; exit 1

wordpress_db="$2"
echo "restore database"
gunzip -c "$wordpress_db" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WORDPRESSDB
echo "done"
exit 0
;;
upgrade | -u)
wordpress="$2"
arch=`echo "$wordpress" | awk -F. '{ print $NF}'`
if [ "$arch" = "zip" -o "$arch" = "gz" ]
then
echo "prepare to upgrade"
[ -d $path/upload/ ] || mkdir $path/upload/
cp -v -R $path/wp-content/ $path/wp-config.php $path/.htaccess $path/upload/
rm $path/wp*.php $path/license.txt $path/readme.html $path/xmlrpc.php
rm -rf $path/wp-admin/ $path/wp-includes/
cp $path/upload/wp-config.php $path

echo "update wordpress"

if [ $arch = zip ]
then
unzip -o $wordpress -d $path
elif [ $arch = gz ]
then
tar xzf $wordpress -C $path --strip-components=1
else
exit 1
fi

cp -rf $path/upload/* $path
rm -rf $path/upload

echo "====================================================================================="
echo "==== For update database you need open <yousite>/wp-admin/upgrade.php in browser ===="
echo "====================================================================================="
else
echo "Неизвестный тип архива, автоопределение работает только для zip и tar.gz"
exit 1

fi
esac

echo "is all!!"

exit 0
</source>

Резервное копирование и восстановление mediawiki

2012-03-16T20:53:01Z

Langator: Новая страница: «__NOTOC__ Представлен скрипт для создания резервных копий, восстановления, обновления mediawiki ...»

__NOTOC__
Представлен скрипт для создания резервных копий, восстановления, обновления mediawiki и расширений.
Особенность обновления расширений заключается в том, что контроль версий поддерживается через svn.
<source lang=bash>

#!/bin/bash

ColorOff='\\e[0m' # Text Reset
BWhite='\\e[1;37m' # Bold White
Blue='\e[0;34m'

#Обязательно вставьте свои значения
WIKIPATH="/www/wiki" #директория установки wiki
BACKUPPATH="/root/backup" #Куда бекапим
MYSQLUSER="user" # mysql пользователь
MYSQLHOST="localhost" # Хост mysql
WIKIDB="wikidb" #mysql база wiki

mediawiki=$1
if [ -z $mediawiki ]
then
echo -e " Введите название архива с wiki для обновления\n\
\e[0;34mbackup\\e[0m или \e[0;34m -b \\e[0m для архивации всех файлов и базы данных wiki\n\
\e[0;34mextensions\\e[0m или \e[0;34m -e \\e[0m для обновления плагинов\n\
\e[0;34mrestorewiki <name>\\e[0m или \e[0;34m -w <name>\\e[0m для восстановления wiki из бекапа\n\
\e[0;34mrestoredb <name>\\e[0m или \e[0;34m -d <name>\\e[0m для восстановления базы данных wiki из бекапа"
exit 1

elif [ `id -u` != 0 ]
then
echo Вы не root
exit 1
fi

dir=`pwd`

case $mediawiki in

backup | -b)
echo "start backup datebase. Wait..."
nice -n 19 mysqldump -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB -c |\
nice -n 19 /bin/gzip -9 > $BACKUPPATH/wiki-wikidb-$(date '+%Y%m%d').sql.gz
echo "backup of database completed"

echo "start backup wiki folder. Wait..."
nice -n 19 tar -czf $BACKUPPATH/aidalinux-wiki-$(date '+%Y%m%d').tar.gz $WIKIPATH
echo "backup wiki completed"

exit 0
;;
extensions | -e)
for extensions in `ls $WIKIPATH/extensions`
do
cd $WIKIPATH/extensions/"$extensions"
svn update
cd ..
done

exit 0
;;
restorewiki | -w)

[[ -z "$2" ]] && echo "Введите назазвание бекапа с wiki"; exit 1

backup_wiki="$2"
echo "restore wiki files"
tar xzvf "$backup_wiki" -C $WIKIPATH --strip-components=1
echo "done"
exit 0
;;
restoredb | -d)

[[ -z "$2" ]] && echo "Введите название бекапа базы данных wiki"; exit 1

wiki_wikidb="$2"
echo "restore datebase"
gunzip -c "$wiki_wikidb" | mysql -h $MYSQLHOST -u $MYSQLUSER -p $WIKIDB
echo "done"
exit 0
;;
esac

#Определение расширения архива с mediawiki
arch=`echo $mediawiki | awk -F. '{ print $NF}'`

if [ "$arch" = gz ]
then
echo "start update mediawiki"
else
echo "Вы ошиблись в вводе аргумента"
exit 1
fi

cd "$dir"

#update mediawiki
tar xzf $mediawiki -C $WIKIPATH --strip-components=1

echo "update database"
php $WIKIPATH/maintenance/update.php
echo "is all!!"
</source>

PortSentry - средство противодействия сканированию портов

2012-03-16T19:04:58Z

Langator:

[[Category:Руководства]]
[[Категория:Net]]
[[Категория:Безопасность]]

= Введение =

Сканирование портов является одним из самых распространенных и простых способов узнать, какая операционная система установлена на компьютере, какие службы запущены в данный момент и получить другую информацию о компьютере, подключенном к Internet , которая может быть использована для взлома и проникновения. Существует много программ для обнаружения сканирования портов. Но обнаружения не достаточно. Должна последовать адекватная реакция. "Адекватная реакция" может заключаться в отправке в сторону сканирующего тебя человека неправильного фрагментированного пакета, ответного сканирования портов, установки на него firewall'а и т.д. Также желательно, чтоб он получил недостоверную информацию об открытых портах на твоем компьютере. Все это и многое другое позволяет делать прекрасная программа Psionic Software Portsentry.

Когда сканирование обнаружено могут последовать следующие ответы:
*занесение информации об инциденте в системный журнал через syslog().
*Компьютер замеченный в сканировании автоматически заносится в файл /etc/host.deny для TCP Wrappers.
*Локальный компьютер автоматически перенастраивается, чтобы направлять весь трафик от атакующего на несуществующий компьютер.
*Локальный компьютер автоматически перенастраивается, чтобы блокировать все пакеты от атакующего пакетным фильтром.

'''''Цель этой программы''''' – дать администратору информацию о том, что их сервер исследуется.

= Установка =

{{Warning|в версии portsentry 1.2 было найдено несколько багов, и поэтому, я рекомендую использовать версию 1.2-r1. Хотя и там ситуация не изменилась. Проблема заключалась в некорректной остановке демона. Ниже будет приведено решение данной проблемы.}}

Для этого необходимо:

<source lang="bash">echo net-analyzer/portsentry ~x86 >> /etc/portage/package.keywords</source>

Устанавливаем программу:

<source lang="bash">emerge -av net-analyzer/portsentry</source>

= Настройка =

{{Warning|Если у вас проблемы с остановкой или перезапуском демона, то необходимо поправить файл {{Path|/etc/init.d/portsentry}}, а точнее разделы ''stop'' и ''restart''.}}

<source lang="bash">stop() {
ebegin "Stopping portsentry"
start-stop-daemon --stop --quiet --exec /usr/bin/portsentry
eend $?
}

restart() {
$stop
$start
}</source>

== Режим работы ==

Portsentry возможно запускать в трех режимах для каждого протокола. Одновременно можно использовать только один режим работы на одном протоколе.

Режим работы задается в файле:

{{Path|/etc/conf.d/portsentry}}

Достаточно раскомментировать необходимую стройку.

=== Classic ===

Работая в данном режиме Portsentry открывает порты, указанные в TCP_PORTS или UDP_PORTS и находится в состоянии ожидания соединения. При попытке подключения к перечисленному порту происходит блокирование удаленного хоста. В этом режиме Portsentry не реагирует на Stealth-сканирование. Данный режим работы задается опциями командной строки: -tcp и -udp , для TCP и UDP-портов соответственно.

=== Enhanced Stealth Scan Detection ===

Данный режим используется для проверки перечисленных в TCP_PORTS или UDP_PORTS портов на предмет подключения или сканирования. Отличительная черта, то что палит практически все типы Stealth-сканирования, а не ограничивается только сканирование подключением. Порты, в отличие от предыдущего режима открытыми не держит, посему атакующий получает достоверную информацию об открытых портах. Задается ключиками командной строки: -stcp и -sudp , для TCP и UDP-портов соответственно.

=== Advanced Stealth Scan Detection ===

Данный режим используется для проверки всех портов входящих в пул от 1 до ADVANCED_PORT_TCP (для TCP) или ADVANCED_PORT_UDP (для UDP). Порты, открытые работающими на хосте программами и перечисленные в ADVANCED_EXLUDE_TCP(для TCP) или ADVANCED_EXCLUDE_UDP(для UDP) не проверяются. Любой хост, попытавшийся подключится к порту из этого промежутка, мгновенно блокируется. Наиболее удобный для использования метод, т.к. реакция на сканирование или попытку подключения у данного метода самая быстрая, а также в этом режиме используется гораздо меньше процессорного времени, чем в остальных. Задается ключами из коммандной строки: -atcp и -audp , TCP и UDP-портов соответственно.

== Конфигурация ==

Приступаем к правке основный конфигурационных файлов. Будем отталкиваться от доступных файлов примеров:

<source lang="bash">cp /etc/portsentry/portsentry.conf.sample /etc/portsentry/portsentry.conf
cp /etc/portsentry/portsentry.ignore.sample /etc/portsentry/portsentry.ignore</source>

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

<source lang="bash">#######################
# Конфигурации портов #
#######################
#
#
# Несколько примеров настроены для классического и основного Stealth
# режимов
#
# Я люблю всегда сохранить некоторые порты в нижнем конце диапазона.
# Это позволит быстро обнаружить последовательное сканирование портов
# и обычно эти порты не используются (например, tcpmux порт 1)
#
# ** Пользователи X-Windows **: Если вы запускаете X на вашем сервере, вам
# нужно быть уверенным, что PortSentry не привязан к порту 6000 (или порту
# 2000 для пользователей OpenWindows).
# Сделав это вы обеспечите правильный старт X-клиента.
#
# Эти привязанные порты игнорируются для режима Advanced Stealth Scan
# Detection Mode.
#
# Раскомментируйте это для чрезвычайного анализа:
TCP_PORTS="1,7,9,11,15,70,79,80,109,110,111,119,138,139,143,512,513,514,515,540,635,1080,1524,2000,2001,4000,4001,5742,6000,6001,6667,12345,12 346,20034,27665,30303,32771,32772,32773,32774,31337,40421,40425,49724,54320"
UDP_PORTS="1,7,9,66,67,68,69,111,137,138,161,162,474,513,517,518,635,640,641,666,700,2049,31335,27444,34555,32770,32771,32772,32773,32774,3133 7,54321"
#
# Используйте их, если вы только хотите знать:
#TCP_PORTS="1,11,15,79,111,119,143,540,635,1080,1524,2000,5742,6667,12345,12346,20034,27665,31337,32771,32772,32773,32774,40421,49724,54320"
#UDP_PORTS="1,7,9,69,161,162,513,635,640,641,700,37444,34555,31335,32770,32771,32772,32773,32774,31337,54321"
#
# Используйте это только для bare-bones
#TCP_PORTS="1,11,15,110,111,143,540,635,1080,1524,2000,12345,12346,20034,32771,32772,32773,32774,49724,54320"
#UDP_PORTS="1,7,9,69,161,162,513,640,700,32770,32771,32772,32773,32774,31337,54321"
###########################################
# Опции Advanced Stealth Scan Detection #
###########################################
#
# Это номера портов, которые PortSentry должен контролировать в
# Advanced mode.
# Любые порты "ниже" этого числа будут контролироваться. Оставьте это
# для контроля всего ниже 1023.
#
# На многих Linux системах нельзя привязать порты выше 61000. Это
# потому, что эти порты используются как часть IP маскарадинга. Я не
# рекомендую вам привязываться к этим номерам портов. Реальность: Я не
# рекомендую использовать порты за 1023, так как это будет приводить к
# ошибочным предупреждениям. Вы были предупреждены!
# Не пишите мне если у вас возникли проблемы, потому что я просто
# высказываю вам свое мнение. Не используйте выше 1023 порта.
#
#
ADVANCED_PORTS_TCP="1024"
ADVANCED_PORTS_UDP="1024"
#
# Это поле говорит PortSentry, что порты (за исключением прослушиваемых
# демонами) игнорируются. Это полезно для услуг, вызываемых ident,
# например FTP, SMTP и wrappers, которые могут остаться не
# запущенными.
#
# По установленным здесь портам PortSentry будет просто не отвечать
# на входящие запросы. Фактически, PortSentry будет их обрабатывать как
# будто они привязаны к демонам. Заданные по умолчанию порты могут
# выступать в отчетах, как возможно ложные сигналы тревоги и
# вероятно должны быть оставлены для всез кроме особо изолированных систем
#
# TCP ident и NetBIOS сервисы
ADVANCED_EXCLUDE_TCP="113,139"
# Default UDP route (RIP), NetBIOS, bootp broadcasts.
ADVANCED_EXCLUDE_UDP="520,138,137,67"

######################
# Конфигурационные файлы #
######################
#
# Игнорируемые хосты
IGNORE_FILE="/etc/portsentry/portsentry.ignore"
# Хосты, которым было отказано в доступе (из истории работы)
HISTORY_FILE="/var/log/portsentry/portsentry.history"
# Компьютеры доступ которым заблокирован только в этой сессии
# (времмено до следующей перезагрузки)
BLOCKED_FILE="/var/log/portsentry/portsentry.blocked"
##############################
# Различные конфигурационные опции #
##############################
#
# Определять ли "имя" атакующего хоста используя DNS Name resolution
# 1 – определять
# 0 – не определять
RESOLVE_HOST = "0"
###################
# Опции ответов #
###################
# Опции ликвидации атакующего. Каждое из этих действий будет
# выполняться если будет обнаружена атака. Если вы не хотите отдельную
# опцию, то комментируйте ее и она будет пропущена.
#
# Переменная $TARGET$ будет замещена целью атаки, когда атака обнаружена.
# Переменная $PORT$ будет заменятьс портом, который был сканирован.
#
##################
# Опции игнорирования #
##################
# Эти опции позволяют вам допустить автоматический параметры ответа для
# UDP/TCP. Это бывает полезно, если вы хотите получить предупреждение о
# соединениях, но не хоти реагировать на определенный протокол.
# Для предотвращения возможных Denial of service атак через UDP и
# определение stealth сканирования для TCP, вы можете пожелать отключить
# блокирование, но оставить предупреждение.
# Лично я предпочитаю ждать начала возникновения проблем до того как
# что-нибудь предпринять, так как большинство атакующих ничего не делают.
# Третья опция позволяет вам запускать внешнюю команду в случае
# сканирования. Это может быть полезно, например, для администраторов,
# которые хотят блокировать TCP, но для UDP будет высылаться
# предупреждения и т.д.
#
#
# 0 = Не блокировать UDP/TCP сканирование.
# 1 = Блокировать UDP/TCP сканирование.
# 2 = Запуск внешней команды (KILL_RUN_CMD)
BLOCK_UDP="1"
BLOCK_TCP="1"
###################
# Сброс маршрутов #
###################
# Эти команды используются для удаления маршрута или
# хоста в локальную таблицу фильтрации.
#
# Шлюз (333.444.555.666) идеально должен быть неработающий хост
# в локальной подсети. На некоторых хостах вместо него используется
# localhost (127.0.0.1), что дает тот же эффект. ЗАМЕТИМ ЧТО
# 333.444.555.66 НЕ БУДЕТ РАБОТАТЬ, ИЗМЕНИТЕ ЭТО!!
#
# ВСЕ ОПЦИИ ОТКЛЮЧЕНИЯ МАРШРУТОВ ИЗНАЧАЛЬНО
# ЗАКОММЕНТИРОВАНЫ. Убедитесь, что вы раскомменировали
# правильные строки для вашей ОС. Если вашей ОС нет в списке
# и вы точно знаете команды сбрасывающие маршруты, то,
# пожалуйста, пришлите их мне. ТОЛЬКО ОДНА KILL_ROUTE ОПЦИЯ
# МОЖЕТ БЫТЬ ИСПОЛЬЗОАНА ОДНОВРЕМЕННО, ТАК ЧТО
# НЕ РАСКОММЕНТИРУЙТЕ БОЛЬШЕ ОДНОЙ СТРОКИ.
#
# ЗАМЕЧАНИЕ: route команды это наименее оптимальная дорога блокирования
# и она не предоставляет полной защиты от UDP атак и
# будет спокойно создавать предупреждения для UDP и stealth сканирований.
# Я всегда рекомендую вам использовать пакетный фильтр, потому что это
# соответствует замыслу.
#
# Общий
#KILL_ROUTE="/sbin/route add $TARGET$ 333.444.555.666"
# Общий для Linux
#KILL_ROUTE="/sbin/route add -host $TARGET$ gw 333.444.555.666"
# Новые версии Linux поддерживают сейчас флаг reject. Это лучше, чем
# вышестоящая опция
#KILL_ROUTE="/sbin/route add -host $TARGET$ reject"
# Общие для BSD (BSDI, OpenBSD, NetBSD, FreeBSD)
#KILL_ROUTE="/sbin/route add $TARGET$ 333.444.555.666"
# Общий для Sun
#KILL_ROUTE="/usr/sbin/route add $TARGET$ 333.444.555.666 1"
# NEXTSTEP
#KILL_ROUTE="/usr/etc/route add $TARGET$ 127.0.0.1 1"
# FreeBSD
#KILL_ROUTE="route add -net $TARGET$ -netmask 255.255.255.255 127.0.0.1 -blackhole"
# Digital UNIX 4.0D (OSF/1 / Compaq Tru64 UNIX)
#KILL_ROUTE="/sbin/route add -host -blackhole $TARGET$ 127.0.0.1"
# Общие для HP-UX
#KILL_ROUTE="/usr/sbin/route add net $TARGET$ netmask 255.255.255.0 127.0.0.1"
##
# Использование пакетного фильтра более предпочтительный метод. Ниже
# перечисленные строки подходят для многих ОС. Помните, вы можете
# раскомментировать только одну строку.
# Опции KILL_ROUTE.
##
# Linux с поддержкой ipfwadm
#KILL_ROUTE="/sbin/ipfwadm -I -i deny -S $TARGET$ -o"
#
#Linux с поддержкой ipfwadm (без логгирования)
#KILL_ROUTE="/sbin/ipfwadm -I -i deny -S $TARGET$"
#
#Linux с поддержкой ipchain
#KILL_ROUTE="/sbin/ipchains -I input -s $TARGET$ -j DENY -l"
#
#Linux с поддержкой ipchain (без логгирования)
#KILL_ROUTE="/sbin/ipchains -I input -s $TARGET$ -j DENY"
#
#Linux с поддержкой iptables
KILL_ROUTE="/sbin/iptables -I portscan_deny -s $TARGET$ -j DROP"
#
#Linux с поддержкой iptables support с лимитированием и логгирование
# лимитирование пакетов обеспечит защиту от DOS атак
# KILL_ROUTE="/sbin/iptables -I INPUT -s $TARGET$ -j DROP && /sbin/iptables -I INPUT -s $TARGET$ -m limit –limit 3/minute –limit-burst 5 -j LOG –log-level DEBUG –log-prefix 'Portsentry: dropping: '"
#
# For those of you running FreeBSD (and compatible) you can
# use their built in firewalling as well.
#
#KILL_ROUTE="/sbin/ipfw add 1 deny all from $TARGET$:255.255.255.255 to any"
#
#
# For those running ipfilt (OpenBSD, etc.)
# NOTE THAT YOU NEED TO CHANGE external_interface TO A VALID INTERFACE!!
#
#KILL_ROUTE="/bin/echo 'block in log on external_interface from $TARGET$/32 to any' | /sbin/ipf -f -"

###############
# TCP Wrappers#
###############
# Этот текст описывает внесение в файл hosts.deny для использования wrappers.
# Зжесь приводятся два формата TCP wrappers:
#
# Формат 1: Старый стиль – по умолчанию, когда хост не допускает обработки
# параметров.
#
#KILL_HOSTS_DENY="ALL: $TARGET$"
# Формат 2: Новый стиль √ включены расширенной обработки.
# Вы можете просмотреть опции расширенной обработки, чтобы
# быть уверенными, что все перед символами "%" стоит символ "\"
# (например, \%c \%h )
#
#KILL_HOSTS_DENY="ALL: $TARGET$ : DENY"
###################
# Внешние команды #
###################
# Эта команда выполняется когда хост подключен, это может быть то, что вам
# нужно (пэйджер и т.д.). Эта команда выполняется перед очисткой маршрута.
#
# Я НЕ РЕКОМЕНДУЮ ПОМЕЩАТЬ КАКИЕ-ЛИБО КАРАТЕЛЬНЫЕ
# ДЕЙСТВИЯ ПРОТИВ ХОСТА СКАНИРУЮЩЕГО ВАС.
#
#TCP/IP это протокол без подтверждения подлинности и люди могут организовать
# сканирование из ниоткуда. Единственное, что можно безопасно запустить
# это скрипт обратной проверки, который использует классический -tcp режим.
# Этот режим требует полного соединения и очень труден для обмана (spoof).
#
# Переменная KILL_RUN_CMD_FIRST должна быть выставлена в "1" для запуска внешней команды
# ДО блокирования. Установите в "0" для выполнения команды ПОСЛЕ блокирования
#
#KILL_RUN_CMD_FIRST = "0"
#
#
KILL_RUN_CMD="/usr/home/script/work/scan_port_mail.sh $TARGET$ $PORT$ $MODE$"
# for examples see /usr/share/doc/portsentry/examples/

#####################
# Значение триггеров сканирования #
#####################
# Введите число соединений к портам, когда вам будет дано предупреждение.
# По умолчанию значение равно 0 – незамедлительная реакция.
# Значения 1 или 2 будут уменьшать количество ложных срабатываний. В более
# высоком значение нет необходимости. Это значение должно быть определено,
# но как правило можно оставить 0.
#
# ЗАМЕЧАНИЕ: Если вы используете продвинутые опции определения, вам
# нужно быть внимательным, чтобы не создать ситуацию "спускового крючка,
# требующего легкого нажатия". Поскольку расширенный режим будет
# реагировать на любой удаленный компьютер соединяющийся с интервалом
# ниже определенного здесь, вы при определенных обстоятельствах
# действительно разорвете что-нибудь. (например, кто-то невинно пытается
# соединиться с вами через SSL [TCP порт 443] и вы сразу блокируете его).
# Так что будьте внимательны.
#
SCAN_TRIGGER="0"
######################
# Секция заголовка (banner) порта #
######################
# Введите здесь текст, который вы хотите показать человеку отключаемого
# PortSentry. Я не рекомендую насмехаться над человек, так как это может его
# разозлить. Оставьте эти строки закомментироваными, чтобы отключить эту
# возможность.
#
# Режим определения Stealth сканирования не использует эту возможность.
#
#PORT_BANNER="** UNAUTHORIZED ACCESS PROHIBITED *** YOUR CONNECTION ATTEMPT HAS BEEN LOGGED. GO AWAY."
# EOF</source>

В файле portsentry.ignore мы упоминаем IP-адреса компьютеров, которые не должны быть блокированы при подключении к отслеживаемому порту. По умолчанию, в файле заданы два IP-адреса: 127.0.0.1 и 0.0.0.0. туда следует добавить внутреннюю сеть и свои сервера.

После этого создаем указанный в конфиге внешний скрипт для отправки почты:

<source lang="bash">mkdir -p /usr/home/script/work/
cd /usr/home/script/work/
touch scan_port_mail.sh
chmod +x scan_port_mail.sh

###################### /usr/home/script/work/scan_port_mail.sh ######################
#!/bin/bash
# оповещение по почте о попытках сканирования хостов

# вводим переменные:
main_e_mail=”root@mail.ru”
attak_date=”`date +%Y-%m-%d`”
attak_time=”`date +%H:%M:%S`”
local_mashine=”`uname -n`”

# достаём хост с которого сканили
hacker_IP=$1
scanned_port=$2

# определяем DNS-атакующего
hacker_DNS=`host ${hacker_IP} | awk ‘{print $5}’`

# ваяем тревожную мессагу
echo ” обнаружена попытка сканирования .
Имя машины: ${local_mashine}
Отсканенные порты: ${scanned_port}

Прикрепляем данные атакующего:
IP: ${hacker_IP}
DNS: ${hacker_DNS}
=======
Атака заблокирована.
” | mail -s port_scanned_on_${local_mashine} ${main_e_mail}

############################</source>

{{Note|Для работы скрипта необходимы: ''mail-client/mailx'' и ''net-dns/bind-tools''}}

В случае фаервола естественно необходимо открыть прослушиваемые порты, для более успешной рыбалки.

= См. также =
[http://odminblog.ru/portsentry-install/ odminblog.ru] 
[http://www.lissyara.su/articles/freebsd/security/portsentry/ lissyara.su]

MediaWiki

2012-03-16T13:20:43Z

Langator: /* Добавляем слева ссылки на другие вики */

== Установка MediaWiki ==

Установка крайне проста: скачиваем последнюю версию с официального сайта http://www.mediawiki.org и распаковываем в нужный каталог сайта (например <tt>/var/www/site/w/</tt>); далее настраиваем через веб-интерфейс. Точка входа <nowiki>http://domain.ru/w/config/</nowiki>

Подробно об установке можно узнать из [http://www.mediawiki.org/wiki/Manual:Installation_guide/ru официальной инструкции], и ещё одна [http://www.mediawiki.org/wiki/Manual:Configuring_MediaWiki/ru здесь].

Вики движок лучше не размещать в корне сайта. Почему, кратко объяснено в [http://www.mediawiki.org/wiki/Manual:Wiki_in_site_root_directory спец. статье].

После установки хорошо бы ознакомиться с [http://www.mediawiki.org/wiki/Manual:System_administration/ru задачами администратора MediaWiki], где сказано что ещё можно доделать.

== Как настроить (кратко) ==

Хорошие краткие инструкции (ЧаВО или FAQ) есть на официальном сайте MediaWiki как на [http://www.mediawiki.org/wiki/Manual:FAQ/ru русском языке], так и на [http://www.mediawiki.org/wiki/Manual:FAQ английском].

=== Запрещаем редактирование не авторизованным пользователям: ===
<source lang="bash">
$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
</source>

=== Делаем ссылки короткими ===

По умолчанию ссылки выглядят так: <nowiki>http://domain.ru/wiki/index.php?title=article</nowiki>. Чтобы сделать их такими же короткими и наглядными, как в Википедии, есть [http://www.mediawiki.org/wiki/Manual:Short_URL много способов]. Один из них - это добавить в '''LocalSettings.php''': 
<source lang="bash">$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;
</source>

где '''$wgScriptPath''' - каталог установки вики-сайта, а '''$wgArticlePath''' - виртуальный каталог, который нужно будет указать в URL при обращении к статье, имя не должно совпадать с реальным каталогом.

Затем, в корневом каталоге сайта (т.е. рядом с каталогом "w") нужно создать файл '''.htaccess''': 
<source lang="bash">RewriteEngine On
RewriteRule ^wiki/(.*)$ /w/index.php?title=$1 [PT,L,QSA]
RewriteRule ^wiki/*$ /w/index.php [L,QSA]
RewriteRule ^/*$ /w/index.php [L,QSA]
</source>

Для лучшего понимания этого кода можно подробней ознакомиться с [http://www.shtogrin.com/library/web/mod_rewrite/doc/RewriteRule/ синтаксисом дерективы RewriteRule].

Если на сервере установлено несклько виртуальных хостов, то нужно ещё добавить  настройку виртуального хоста в секцию '''<VirtualHost>''':

<source lang="bash">RewriteEngine On
RewriteOptions Inherit</source>

и подключить модуль rewrite, после чего перезагрузить сервер. В Debian это делается следующим образом:
<source lang="bash">ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled
/etc/init.d/apache2 restart
</source>

=== Добавляем логотип ===

Картинку не более 135х135 пикселей с прозрачным фоном загружаем в папку images и добавляем в '''LocalSettings.php''': 
<source lang="bash">$wgLogo = “{$wgScriptPath}/images/logofinal.png”;</source>

=== '''Меняем favicon''' ===

Это изображение появляется возле адреса страницы в адресной строке сайта, а также в закладках. Его размер должен быть либо 16x16 либо 32x32 пикселей. Не все браузеры поддерживают формат favicon отличный от ico, подробней читайте на http://en.wikipedia.org/wiki/Favicon#Browser_support

Чтобы добавить favicon.ico можно
* положить как обычно в корневой каталог сайта, т.е. на одном уровне с каталогом "w/" или
* скопировать изображение в папку images и добавить в '''LocalSettings.php''':
<source lang="bash">$wgFavicon = "$wgScriptPath/images/favicon.ico";</source>

=== Настраиваем навигационную панель (слева) ===

Создаём страницу '''MediaWiki:Sidebar''', где описываем содержание навигационной панели.

'''Синтаксис:'''

<source lang="bash">
* <название блока 1>
** <ссылка на статью 1>|<отображаемый текст 1>
** <ссылка на статью 2>|<отображаемый текст 2>
* <название блока 2>
** <ссылка на статью 3>|<отображаемый текст 3>
** <ссылка на статью 4>|<отображаемый текст 4></source>

'''Пример:'''
<source lang="bash">
* navigation
** mainpage|Начальная
** Служебная:AllPages|Все статьи
** Служебная:Categories|Все категории
** portal-url|Сообщество
** helppage|help
* Популярное
** Служебная:PopularPages|Статьи
** Служебная:MostLinkedCategories|Категории
** recentchanges-url|recentchanges
** randompage-url|randompage
* SEARCH
* TOOLBOX
</source>

=== Добавляем слева ссылки на другие вики===

В случае многоязыковых проектов достаточно добавить в статью
<source lang="bash">[[lang:Имя статьи]]</source>

где '''lang''' - префикс языка. См. файл '''languages/Names.php'''

В случае, если нужно добавить ссылку на любой другой сайт, нужно создать интервики ссылку (см. ниже) и с таким же именем запись в languages/Names.php

Например, в таблице ссылок интервики создали ссылку '''my-wiki''', тогда в Names.php добавляем строчку (в рамках объявления массива):
<source lang="bash">'my-wiki' => 'My Wiki', # Link to my wiki</source>

Теперь, в статью можно поместить строку:
<source lang="bash">[[my-wiki:Имя статьи]]</source>

Подробней читать на [http://www.mediawiki.org/wiki/Manual:Interwiki/ru офф. сайте].

=== Меняем права пользователей ===

Права пользователя можно поменять на '''Special:Userrights'''. Подробно описано в [http://www.mediawiki.org/wiki/Manual:User_rights_management официальном руководстве].

=== Меняем пароль пользователя ===

Пароль любого пользователя можно поменять SQL командой:

<source lang="mysql">UPDATE user SET user_password = MD5(CONCAT(user_id, '-', MD5('Новый_Пароль'))) WHERE user_name = 'Имя_Пользователя';</source>

===Разрешаем включать страницы из других вики===

Чтобы включить страницу или шаблон из другой вики, она должна быть описана в таблице интервики ссылок и в LocalSettings.php нужно добавить параметр [http://www.mediawiki.org/wiki/Manual:$wgEnableScaryTranscluding $wgEnableScaryTranscluding]:

<source lang="bash">$wgEnableScaryTranscluding = true;</source>

:'''!''' В версии '''MediaWiki 16.2''' при попытке подключить внешний шаблон <nowiki>{{WikiName:Template:TemplateName}}</nowiki> PHP выдаёт ошибку:

PHP Fatal error: Cannot redeclare class HttpRequest in /local_path_to_site/w/includes/HttpFunctions.php on line 122

=== Разрешаем загружать файлы ===

<syntaxhighlight lang=bash>
# Позволяем загружать файлы
$wgEnableUploads = true;

# Определяем макс. размер файла
$wgMaxUploadSize = 5000000;

# Отключаем проверку расширения файла
$wgCheckFileExtensions = false;
$wgStrictFileExtensions = false;
</syntaxhighlight>

Последние два параметра разрешают загружать все файлы (что не безопасно). Если их не указывать, то по умолчанию будут разрешены только изображения.

Чтобы самостоятельно задать тип файлов указываем:
<syntaxhighlight lang=bash>
$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg', 'pdf', 'doc', 'docx', 'xls', 'xlsx','ods','odg','odt');
</syntaxhighlight>

Для того, чтобы файлы могли быть загруженными, должен быть настроен и сам PHP.

Подробней см. [http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads/ru официальную документацию].

=== Добавляем классы таблиц ===

{|class="frame collapsible collapsed" align=right
! код для shared.css
|-
|
<syntaxhighlight lang=css>
/* -pm- as wikitable but without a table */
/*background and darker header background*/
table.standard {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
}
.standard th, .standard td {
border: 1px #aaa solid;
padding: 0.2em;
}
.standard th {
background: #d2d2d2;
text-align: center;
}
.standard caption {
font-weight: bold;
}

/* -pm- as standart but with frame only */
table.frame {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
}
.frame th .frame td {
padding: 0.2em;
}
.frame th {
background: #d2d2d2;
text-align: center;
}
.frame caption {
font-weight: bold;
}

/* -pm- as standart but wide (100%) */
table.wide {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
width: 100%;
}
.wide th, .wide td {
border: 1px #aaa solid;
padding: 0.2em;
}
.wide th {
background: #d2d2d2;
text-align: center;
}
.wide caption {
font-weight: bold;
}

/* -pm- as wide but with frame only*/
table.wide-frame {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
width: 100%;
}
.wide-frame th .wide-frame td {
padding: 0.2em;
}
.wide-frame th {
background: #d2d2d2;
text-align: center;
}
.wide-frame caption {
font-weight: bold;
}
</syntaxhighlight>
|}

По умолчанию в движке MediaWiki определён только один класс таблиц wikitable.
* Чтобы определить свои классы нужно отредактировать файл <tt>skins/common/shared.css</tt>. Вставьте в любое место приведённый справа код.
Пример классов таблиц:
{| class=frame
|-
! вид

|
{| class="wikitable"
|+ wikitable
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|
{| class="standard sortable"
|+ standard
|-
!Заголовок 1||Заголовок 2
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка
|-
| 3 Ячейка || 3 Ячейка
|}

|
{| class="frame sortable"
|+ frame
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3
|-
| E || Щ || 2
|-
| F || Б || 11
|}

|-
! код

|<pre>
{| class="wikitable"
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
</pre>

|<pre>
{| class="standard sortable"
|-
!Заголовок 1||Заголовок 2
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка
|-
| 3 Ячейка || 3 Ячейка
|}
</pre>

|<pre>
{| class="frame sortable"
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3
|-
| E || Щ || 2
|-
| F || Б || 11
|}
</pre>
|}

{| class=frame width=600
|-
! width=50|широкие

|
{| class="wide"
|+ wide
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|-
!
|
{| class="wide-frame"
|+ wide-frame
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
|}

* Можно добавить возможность [http://www.mediawiki.org/wiki/Manual:Collapsible_tables сворачивать таблицы]. В официальной инструкции рекомендуется создать в вики страницы '''Common.js''' и '''Common.css''', но в случае вики семьи такое решение не подойдёт, так действует только на одну вики, поэтому я добавил код в конец следующих файлов в каталоге <tt>skins/common/</tt>:
** код для Common.js добавил в <tt>ajax.js</tt>
** код для Common.css добавил в <tt>shared.css</tt>

Скопируйте и вставте следующий код в [[MediaWiki:Common.js]] и [[MediaWiki:Common.css]]:

{|class="frame collapsible collapsed"
! код для Common.js
|-
|
<syntaxhighlight lang=javascript>
/** Collapsible tables *********************************************************
*
* Description: Allows tables to be collapsed, showing only the header. See
* http://www.mediawiki.org/wiki/Manual:Collapsible_tables.
* Maintainers: [[en:User:R. Koot]]
*/

var autoCollapse = 2;
var collapseCaption = 'hide';
var expandCaption = 'show';

function collapseTable( tableIndex ) {
var Button = document.getElementById( 'collapseButton' + tableIndex );
var Table = document.getElementById( 'collapsibleTable' + tableIndex );

if ( !Table || !Button ) {
return false;
}

var Rows = Table.rows;

if ( Button.firstChild.data == collapseCaption ) {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = 'none';
}
Button.firstChild.data = expandCaption;
} else {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = Rows[0].style.display;
}
Button.firstChild.data = collapseCaption;
}
}

function createCollapseButtons() {
var tableIndex = 0;
var NavigationBoxes = new Object();
var Tables = document.getElementsByTagName( 'table' );

for ( var i = 0; i < Tables.length; i++ ) {
if ( hasClass( Tables[i], 'collapsible' ) ) {

/* only add button and increment count if there is a header row to work with */
var HeaderRow = Tables[i].getElementsByTagName( 'tr' )[0];
if ( !HeaderRow ) {
continue;
}
var Header = HeaderRow.getElementsByTagName( 'th' )[0];
if ( !Header ) {
continue;
}

NavigationBoxes[tableIndex] = Tables[i];
Tables[i].setAttribute( 'id', 'collapsibleTable' + tableIndex );

var Button = document.createElement( 'span' );
var ButtonLink = document.createElement( 'a' );
var ButtonText = document.createTextNode( collapseCaption );

Button.className = 'collapseButton'; // Styles are declared in [[MediaWiki:Common.css]]

ButtonLink.style.color = Header.style.color;
ButtonLink.setAttribute( 'id', 'collapseButton' + tableIndex );
ButtonLink.setAttribute( 'href', "javascript:collapseTable(" + tableIndex + ");" );
ButtonLink.appendChild( ButtonText );

Button.appendChild( document.createTextNode( '[' ) );
Button.appendChild( ButtonLink );
Button.appendChild( document.createTextNode( ']' ) );

Header.insertBefore( Button, Header.childNodes[0] );
tableIndex++;
}
}

for ( var i = 0; i < tableIndex; i++ ) {
if ( hasClass( NavigationBoxes[i], 'collapsed' ) || ( tableIndex >= autoCollapse && hasClass( NavigationBoxes[i], 'autocollapse' ) ) ) {
collapseTable( i );
} else if ( hasClass( NavigationBoxes[i], 'innercollapse' ) ) {
var element = NavigationBoxes[i];
while ( element = element.parentNode ) {
if ( hasClass( element, 'outercollapse' ) ) {
collapseTable( i );
break;
}
}
}
}
}

addOnloadHook( createCollapseButtons );

/** Test if an element has a certain class **************************************
*
* Description: Uses regular expressions and caching for better performance.
* Maintainers: [[User:Mike Dillon]], [[User:R. Koot]], [[User:SG]]
*/

var hasClass = ( function() {
var reCache = {};
return function( element, className ) {
return ( reCache[className] ? reCache[className] : ( reCache[className] = new RegExp( "(?:\\s|^)" + className + "(?:\\s|$)" ) ) ).test( element.className );
};
})();
</syntaxhighlight>
|}
{|class="frame collapsible collapsed"
! код для Common.css
|-
|
<syntaxhighlight lang=css>
table.collapsed tr.collapsible {
display: none;
}

.collapseButton { /* 'show'/'hide' buttons created dynamically by the */
float: right; /* CollapsibleTables JavaScript in [[MediaWiki:Common.js]] */
font-weight: normal; /* are styled here so they can be customised. */
text-align: right;
width: auto;
}
</syntaxhighlight>
|}

== Добавление расширений ==

Список всех уже установленных расширений можно увидеть на странице [[:Special:Version]] а в руссифицированных версиях также [[:Служебная:Version]]

Все расширения (extensions) устанавливаются в MediaWiki одинаково:
# копируются в свой подкаталог в каталоге extensions. Список расширений можно узнать из [http://www.mediawiki.org/wiki/Extension_Matrix официального списка].
# в '''LocalSettings.php''' добавляется строка:
<source lang="bash">
require_once( "$IP/extensions/Каталог_Расширения/Главный_Файл_Расширения.php" );
</source>

'''Некоторые полезные расширения'''

* [http://www.mediawiki.org/wiki/Extension:FCKeditor_%28Official%29 FCKeditor] - визуальный (WYSIWYG) редактор. У этого расширения можно обновить сам [http://ckeditor.com/download редактор]. Подключаем:
<source lang="bash">
require_once( "$IP/extensions/FCKeditor/FCKeditor.php" );
</source>

* [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite.php] - добавляет поддержку тэгов '''<nowiki><ref></nowiki>''' и '''<nowiki><references /></nowiki>''', что позволяет использовать в тексте статьи сноски. Подключаем:
<source lang="bash">
require_once( "$IP/extensions/Cite/Cite.php" );
</source>

* [http://www.mediawiki.org/wiki/Extension:ParserFunctions/ru ParserFunctions] - позволяет использовать тэги: '''<nowiki>#expr: #if: #ifeq: #ifexist: #ifexpr: #switch: #time: #rel2abs: #titleparts: #iferror:</nowiki>'''. На Википедии можно почитать как использовать [http://ru.wikipedia.org/wiki/Википедия:Функции_парсера функции парсера]. Устанавливать лучше из репозитория Subversion (скачать [http://subversion.apache.org/packages.html#windows клиент]):
<source lang="bash">
cd extensions/
svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ParserFunctions
</source>

* [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi] - подсветка синтаксиса программного кода, позволяет использовать тэги '''<nowiki><syntaxhighlight> и <source></nowiki>'''. Это расширенная версия [http://www.mediawiki.org/wiki/Extension:Geshi GeSHi]

<source lang="bash">
cd extensions/
svn co svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi
</source>

Подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
</syntaxhighlight>

'''Параметры:'''

** '''lang'''="??": Определяет язык программировария, сказывается на самой подсветке
** '''line'''="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS": Как нумеровать линии (по умолчанию никак)
** '''line start'''="??": Какой номер у первой строки, используется вместе с line
** '''highlight'''="??": Какую линию подсветить, не зависит от line start
** '''enclose'''="??": В какой контейнер поместить блок. Принимает значения "pre" (по умолчанию), "div", "none".
** '''strict''': Присутствие этого параметра указывает, что нужно использовать режим strict.

* [http://www.mediawiki.org/wiki/Extension:CategoryTree CategoryTree] - добавляет более удобную навигацию по категориям. Позволяет использовать тэг <nowiki><categorytree></nowiki>

Копируем в каталог расширений и подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/CategoryTree/CategoryTree.php");
</syntaxhighlight>

* [http://www.mediawiki.org/wiki/Extension:Collection Collection] - даёт возможность создавать книги в формате PDF из статей сайта.

'''! Требует чтобы PHP поддерживал cURL !''' Возможно потребуется доуставить.

Копируем в каталог расширений и подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/Collection/Collection.php");
</syntaxhighlight>

Чтобы дать пользователям возможность сохранять и делиться своими книгами с другими, добавьте в Localsettings.php:

<syntaxhighlight lang=php>
$wgGroupPermissions['user']['collectionsaveasuserpage'] = true;
$wgGroupPermissions['user']['collectionsaveascommunitypage'] = true;
</syntaxhighlight>

С настройками по умолчанию книги будут генерироваться на сервере разработчика этого расширения.

* [http://www.mediawiki.org/wiki/Extension:CharInsert CharInsert] - быстрое добавление любых символов или шаблонных тегов. Ниже окна редактирования размещается дополнительная панель инструментов.

== Резервное копирование ==

Чтобы узнать, как скачать дампы базы данных со статьями Википедии, см. [http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Linux/ru статью Википедии]

Для создания собственного дампа локального сайта, использующего MediaWiki, есть [http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki/ru подробная инструкция].

Если кратко, то полная резервная копия - это дамп из СУБД (у меня MySQL) в виде SQL выражений, а частичная в виде xml файла. Особенности последней в том, что она не зависит от структуры базы данных и может быть перенесена, например, на нувую версию MediaWiki с изменнённой структурой БД, но в xml не выгружаются информация о логинаx пользователей, журналы и метаданные изображений.

*Для '''SQL''' дампа выполняем:
<source lang="mysql">
mysqldump -h $SERVER -u $USER -p$PASSWORD --default-character-set=$CHARSET $DATABASE -c \
| /bin/gzip -9 > ~/backup/wiki-$(date '+%a').sql.gz
</source>

:параметры '''$USER''', '''$PASSWORD''' и '''$DATABASE''' берём из LocalSettings.php
:<source lang="bash">cat ./LocalSettings.php | grep wgDB</source>

:параметр '''--default-character-set=$CHARSET''' нужен, если возникли проблемы с кодировкой (подробней см. статью выше)

:параметр '''-h $SERVER''' нужен если подключаемся не через сокет, иначе получим ошибку:
:<pre>mysqldump: Got error: 2002: Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) when trying to connect</pre>

*Для '''XML''' дампа используем скрипт [http://www.mediawiki.org/wiki/Manual:DumpBackup.php dumpBackup.php], расположенный в каталоге '''maintenance''':
<source lang="bash">
php maintenance\dumpBackup.php --full > full.xml</source>

Список параметров dumpBackup.php можно получить, вызвав его без параметров, однако, в исходном коде этого скрипта есть ещё несколько недокументированных опций.

== Редактировние статей ==

Об этом можно подробно узнать из [[Справка:Содержание|Справки по редактированию]].

== Уменьшение нагрузки ==

Полезно запретить поисковым роботам индексировать все служебные страницы, а ограничить их только статьями. Для этого редактируем файл '''robots.txt''' в корне сайта:

<source lang="bash">User-agent: *
Disallow: /w/</source>

В случае [[MediaWiki/Wiki_family_(farm)|вики семьи]] (фермы), в корневой каталог сайта кладём:

<source lang="bash"> User-agent: *
Disallow: /w/
Disallow: /ru/w-
Disallow: /en/w-
</source>
а в языковые подкаталоги:

<source lang="bash"> User-agent: *
Disallow: /w/
Disallow: /w-</source>

Подробнее см. на [http://www.mediawiki.org/wiki/Robots.txt официальном сайте]

==Дополнительные настройки==

* [http://www.mediawiki.org/wiki/Manual:Interwiki/ru Интервики] (interwiki) - это ссылки, оформленные как внутренние ссылки с использованием специального префикса, но ведущие на страницы других проектов. Интервики-ссылки позволяют сделать ссылку на страницы других вики-проектов, например Википедии, Викиучебника, Викиновостей и т.д., или, к примеру, на разделы вашего вики-проекта на разных языках.
** [http://www.mediawiki.org/wiki/Extension:Interwiki расширение Interwiki] позволяет редактировать таблицу интервики ссылок.

* [http://www.mediawiki.org/wiki/Manual:Tagline_(Site_Subtitle) Tagline] - можно изменить подпись "'''Материал из НазваниеВики'''".

== Полезные ссылки ==

'''Документация:'''
* http://meta.wikimedia.org/wiki/Помощь:Содержание
* http://ru.wikibooks.org/wiki/Вики - небольшой Викиучебник

'''Советы по настройке:'''
* http://ru.wikia.com/wiki/Настройка_вики
* http://docs.altlinux.org/archive/4.1/school_server/mediawiki/index.html
* http://homo-creativus.info/tag/mediawiki/

'''Справочники:'''
* http://www.wikireality.ru/wiki/Настройки_конфигурации_MediaWiki_(по_алфавиту) - описание всех параметров LocalSettings.php на русском языке

'''Скины:'''
* Инструкции как сделать свой скин
** на [http://wiki.auditory.ru/Создание_скинов_для_MediaWiki русском языке]
** на [http://www.siteground.com/tutorials/mediawiki/mediawiki_skins.htm английском]
** полная [http://www.mediawiki.org/wiki/Skinning официальная]

* Сайты со скинами
** http://mediawiki2u.com/

'''Утилиты:'''
* http://www.mediawiki.org/wiki/Extension:Word2MediaWikiPlus - Утилита для конвертации файлов MS Word 2007 в формат текста MediaWiki

'''Описание движка MediaWiki:'''
* http://www.mediawiki.org/wiki/Category:MediaWiki_database_tables - Таблицы
[[Category:Руководства]] [[Категория:Net]][[Категория:MediaWiki]]

MediaWiki

2012-03-16T13:15:57Z

Langator:

== Установка MediaWiki ==

Установка крайне проста: скачиваем последнюю версию с официального сайта http://www.mediawiki.org и распаковываем в нужный каталог сайта (например <tt>/var/www/site/w/</tt>); далее настраиваем через веб-интерфейс. Точка входа <nowiki>http://domain.ru/w/config/</nowiki>

Подробно об установке можно узнать из [http://www.mediawiki.org/wiki/Manual:Installation_guide/ru официальной инструкции], и ещё одна [http://www.mediawiki.org/wiki/Manual:Configuring_MediaWiki/ru здесь].

Вики движок лучше не размещать в корне сайта. Почему, кратко объяснено в [http://www.mediawiki.org/wiki/Manual:Wiki_in_site_root_directory спец. статье].

После установки хорошо бы ознакомиться с [http://www.mediawiki.org/wiki/Manual:System_administration/ru задачами администратора MediaWiki], где сказано что ещё можно доделать.

== Как настроить (кратко) ==

Хорошие краткие инструкции (ЧаВО или FAQ) есть на официальном сайте MediaWiki как на [http://www.mediawiki.org/wiki/Manual:FAQ/ru русском языке], так и на [http://www.mediawiki.org/wiki/Manual:FAQ английском].

=== Запрещаем редактирование не авторизованным пользователям: ===
<source lang="bash">
$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
</source>

=== Делаем ссылки короткими ===

По умолчанию ссылки выглядят так: <nowiki>http://domain.ru/wiki/index.php?title=article</nowiki>. Чтобы сделать их такими же короткими и наглядными, как в Википедии, есть [http://www.mediawiki.org/wiki/Manual:Short_URL много способов]. Один из них - это добавить в '''LocalSettings.php''': 
<source lang="bash">$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;
</source>

где '''$wgScriptPath''' - каталог установки вики-сайта, а '''$wgArticlePath''' - виртуальный каталог, который нужно будет указать в URL при обращении к статье, имя не должно совпадать с реальным каталогом.

Затем, в корневом каталоге сайта (т.е. рядом с каталогом "w") нужно создать файл '''.htaccess''': 
<source lang="bash">RewriteEngine On
RewriteRule ^wiki/(.*)$ /w/index.php?title=$1 [PT,L,QSA]
RewriteRule ^wiki/*$ /w/index.php [L,QSA]
RewriteRule ^/*$ /w/index.php [L,QSA]
</source>

Для лучшего понимания этого кода можно подробней ознакомиться с [http://www.shtogrin.com/library/web/mod_rewrite/doc/RewriteRule/ синтаксисом дерективы RewriteRule].

Если на сервере установлено несклько виртуальных хостов, то нужно ещё добавить  настройку виртуального хоста в секцию '''<VirtualHost>''':

<source lang="bash">RewriteEngine On
RewriteOptions Inherit</source>

и подключить модуль rewrite, после чего перезагрузить сервер. В Debian это делается следующим образом:
<source lang="bash">ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled
/etc/init.d/apache2 restart
</source>

=== Добавляем логотип ===

Картинку не более 135х135 пикселей с прозрачным фоном загружаем в папку images и добавляем в '''LocalSettings.php''': 
<source lang="bash">$wgLogo = “{$wgScriptPath}/images/logofinal.png”;</source>

=== '''Меняем favicon''' ===

Это изображение появляется возле адреса страницы в адресной строке сайта, а также в закладках. Его размер должен быть либо 16x16 либо 32x32 пикселей. Не все браузеры поддерживают формат favicon отличный от ico, подробней читайте на http://en.wikipedia.org/wiki/Favicon#Browser_support

Чтобы добавить favicon.ico можно
* положить как обычно в корневой каталог сайта, т.е. на одном уровне с каталогом "w/" или
* скопировать изображение в папку images и добавить в '''LocalSettings.php''':
<source lang="bash">$wgFavicon = "$wgScriptPath/images/favicon.ico";</source>

=== Настраиваем навигационную панель (слева) ===

Создаём страницу '''MediaWiki:Sidebar''', где описываем содержание навигационной панели.

'''Синтаксис:'''

<source lang="bash">
* <название блока 1>
** <ссылка на статью 1>|<отображаемый текст 1>
** <ссылка на статью 2>|<отображаемый текст 2>
* <название блока 2>
** <ссылка на статью 3>|<отображаемый текст 3>
** <ссылка на статью 4>|<отображаемый текст 4></source>

'''Пример:'''
<source lang="bash">
* navigation
** mainpage|Начальная
** Служебная:AllPages|Все статьи
** Служебная:Categories|Все категории
** portal-url|Сообщество
** helppage|help
* Популярное
** Служебная:PopularPages|Статьи
** Служебная:MostLinkedCategories|Категории
** recentchanges-url|recentchanges
** randompage-url|randompage
* SEARCH
* TOOLBOX
</source>

=== Добавляем слева ссылки на другие вики===

В случае многоязыковых проектов достаточно добавить в статью
<pre>[[lang:Имя статьи]]</pre>

где '''lang''' - префикс языка. См. файл '''languages/Names.php'''

В случае, если нужно добавить ссылку на любой другой сайт, нужно создать интервики ссылку (см. ниже) и с таким же именем запись в languages/Names.php

Например, в таблице ссылок интервики создали ссылку '''my-wiki''', тогда в Names.php добавляем строчку (в рамках объявления массива):
'my-wiki' => 'My Wiki', # Link to my wiki

Теперь, в статью можно поместить строку:
<pre>[[my-wiki:Имя статьи]]</pre>

Подробней читать на [http://www.mediawiki.org/wiki/Manual:Interwiki/ru офф. сайте].

=== Меняем права пользователей ===

Права пользователя можно поменять на '''Special:Userrights'''. Подробно описано в [http://www.mediawiki.org/wiki/Manual:User_rights_management официальном руководстве].

=== Меняем пароль пользователя ===

Пароль любого пользователя можно поменять SQL командой:

<source lang="mysql">UPDATE user SET user_password = MD5(CONCAT(user_id, '-', MD5('Новый_Пароль'))) WHERE user_name = 'Имя_Пользователя';</source>

===Разрешаем включать страницы из других вики===

Чтобы включить страницу или шаблон из другой вики, она должна быть описана в таблице интервики ссылок и в LocalSettings.php нужно добавить параметр [http://www.mediawiki.org/wiki/Manual:$wgEnableScaryTranscluding $wgEnableScaryTranscluding]:

<source lang="bash">$wgEnableScaryTranscluding = true;</source>

:'''!''' В версии '''MediaWiki 16.2''' при попытке подключить внешний шаблон <nowiki>{{WikiName:Template:TemplateName}}</nowiki> PHP выдаёт ошибку:

PHP Fatal error: Cannot redeclare class HttpRequest in /local_path_to_site/w/includes/HttpFunctions.php on line 122

=== Разрешаем загружать файлы ===

<syntaxhighlight lang=bash>
# Позволяем загружать файлы
$wgEnableUploads = true;

# Определяем макс. размер файла
$wgMaxUploadSize = 5000000;

# Отключаем проверку расширения файла
$wgCheckFileExtensions = false;
$wgStrictFileExtensions = false;
</syntaxhighlight>

Последние два параметра разрешают загружать все файлы (что не безопасно). Если их не указывать, то по умолчанию будут разрешены только изображения.

Чтобы самостоятельно задать тип файлов указываем:
<syntaxhighlight lang=bash>
$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg', 'pdf', 'doc', 'docx', 'xls', 'xlsx','ods','odg','odt');
</syntaxhighlight>

Для того, чтобы файлы могли быть загруженными, должен быть настроен и сам PHP.

Подробней см. [http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads/ru официальную документацию].

=== Добавляем классы таблиц ===

{|class="frame collapsible collapsed" align=right
! код для shared.css
|-
|
<syntaxhighlight lang=css>
/* -pm- as wikitable but without a table */
/*background and darker header background*/
table.standard {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
}
.standard th, .standard td {
border: 1px #aaa solid;
padding: 0.2em;
}
.standard th {
background: #d2d2d2;
text-align: center;
}
.standard caption {
font-weight: bold;
}

/* -pm- as standart but with frame only */
table.frame {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
}
.frame th .frame td {
padding: 0.2em;
}
.frame th {
background: #d2d2d2;
text-align: center;
}
.frame caption {
font-weight: bold;
}

/* -pm- as standart but wide (100%) */
table.wide {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
width: 100%;
}
.wide th, .wide td {
border: 1px #aaa solid;
padding: 0.2em;
}
.wide th {
background: #d2d2d2;
text-align: center;
}
.wide caption {
font-weight: bold;
}

/* -pm- as wide but with frame only*/
table.wide-frame {
margin: 1em 1em 1em 0;
border: 1px #aaa solid;
border-collapse: collapse;
width: 100%;
}
.wide-frame th .wide-frame td {
padding: 0.2em;
}
.wide-frame th {
background: #d2d2d2;
text-align: center;
}
.wide-frame caption {
font-weight: bold;
}
</syntaxhighlight>
|}

По умолчанию в движке MediaWiki определён только один класс таблиц wikitable.
* Чтобы определить свои классы нужно отредактировать файл <tt>skins/common/shared.css</tt>. Вставьте в любое место приведённый справа код.
Пример классов таблиц:
{| class=frame
|-
! вид

|
{| class="wikitable"
|+ wikitable
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|
{| class="standard sortable"
|+ standard
|-
!Заголовок 1||Заголовок 2
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка
|-
| 3 Ячейка || 3 Ячейка
|}

|
{| class="frame sortable"
|+ frame
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3
|-
| E || Щ || 2
|-
| F || Б || 11
|}

|-
! код

|<pre>
{| class="wikitable"
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
</pre>

|<pre>
{| class="standard sortable"
|-
!Заголовок 1||Заголовок 2
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка
|-
| 3 Ячейка || 3 Ячейка
|}
</pre>

|<pre>
{| class="frame sortable"
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3
|-
| E || Щ || 2
|-
| F || Б || 11
|}
</pre>
|}

{| class=frame width=600
|-
! width=50|широкие

|
{| class="wide"
|+ wide
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|-
!
|
{| class="wide-frame"
|+ wide-frame
|-
!Заголовок 1||Заголовок 2
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
|}

* Можно добавить возможность [http://www.mediawiki.org/wiki/Manual:Collapsible_tables сворачивать таблицы]. В официальной инструкции рекомендуется создать в вики страницы '''Common.js''' и '''Common.css''', но в случае вики семьи такое решение не подойдёт, так действует только на одну вики, поэтому я добавил код в конец следующих файлов в каталоге <tt>skins/common/</tt>:
** код для Common.js добавил в <tt>ajax.js</tt>
** код для Common.css добавил в <tt>shared.css</tt>

Скопируйте и вставте следующий код в [[MediaWiki:Common.js]] и [[MediaWiki:Common.css]]:

{|class="frame collapsible collapsed"
! код для Common.js
|-
|
<syntaxhighlight lang=javascript>
/** Collapsible tables *********************************************************
*
* Description: Allows tables to be collapsed, showing only the header. See
* http://www.mediawiki.org/wiki/Manual:Collapsible_tables.
* Maintainers: [[en:User:R. Koot]]
*/

var autoCollapse = 2;
var collapseCaption = 'hide';
var expandCaption = 'show';

function collapseTable( tableIndex ) {
var Button = document.getElementById( 'collapseButton' + tableIndex );
var Table = document.getElementById( 'collapsibleTable' + tableIndex );

if ( !Table || !Button ) {
return false;
}

var Rows = Table.rows;

if ( Button.firstChild.data == collapseCaption ) {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = 'none';
}
Button.firstChild.data = expandCaption;
} else {
for ( var i = 1; i < Rows.length; i++ ) {
Rows[i].style.display = Rows[0].style.display;
}
Button.firstChild.data = collapseCaption;
}
}

function createCollapseButtons() {
var tableIndex = 0;
var NavigationBoxes = new Object();
var Tables = document.getElementsByTagName( 'table' );

for ( var i = 0; i < Tables.length; i++ ) {
if ( hasClass( Tables[i], 'collapsible' ) ) {

/* only add button and increment count if there is a header row to work with */
var HeaderRow = Tables[i].getElementsByTagName( 'tr' )[0];
if ( !HeaderRow ) {
continue;
}
var Header = HeaderRow.getElementsByTagName( 'th' )[0];
if ( !Header ) {
continue;
}

NavigationBoxes[tableIndex] = Tables[i];
Tables[i].setAttribute( 'id', 'collapsibleTable' + tableIndex );

var Button = document.createElement( 'span' );
var ButtonLink = document.createElement( 'a' );
var ButtonText = document.createTextNode( collapseCaption );

Button.className = 'collapseButton'; // Styles are declared in [[MediaWiki:Common.css]]

ButtonLink.style.color = Header.style.color;
ButtonLink.setAttribute( 'id', 'collapseButton' + tableIndex );
ButtonLink.setAttribute( 'href', "javascript:collapseTable(" + tableIndex + ");" );
ButtonLink.appendChild( ButtonText );

Button.appendChild( document.createTextNode( '[' ) );
Button.appendChild( ButtonLink );
Button.appendChild( document.createTextNode( ']' ) );

Header.insertBefore( Button, Header.childNodes[0] );
tableIndex++;
}
}

for ( var i = 0; i < tableIndex; i++ ) {
if ( hasClass( NavigationBoxes[i], 'collapsed' ) || ( tableIndex >= autoCollapse && hasClass( NavigationBoxes[i], 'autocollapse' ) ) ) {
collapseTable( i );
} else if ( hasClass( NavigationBoxes[i], 'innercollapse' ) ) {
var element = NavigationBoxes[i];
while ( element = element.parentNode ) {
if ( hasClass( element, 'outercollapse' ) ) {
collapseTable( i );
break;
}
}
}
}
}

addOnloadHook( createCollapseButtons );

/** Test if an element has a certain class **************************************
*
* Description: Uses regular expressions and caching for better performance.
* Maintainers: [[User:Mike Dillon]], [[User:R. Koot]], [[User:SG]]
*/

var hasClass = ( function() {
var reCache = {};
return function( element, className ) {
return ( reCache[className] ? reCache[className] : ( reCache[className] = new RegExp( "(?:\\s|^)" + className + "(?:\\s|$)" ) ) ).test( element.className );
};
})();
</syntaxhighlight>
|}
{|class="frame collapsible collapsed"
! код для Common.css
|-
|
<syntaxhighlight lang=css>
table.collapsed tr.collapsible {
display: none;
}

.collapseButton { /* 'show'/'hide' buttons created dynamically by the */
float: right; /* CollapsibleTables JavaScript in [[MediaWiki:Common.js]] */
font-weight: normal; /* are styled here so they can be customised. */
text-align: right;
width: auto;
}
</syntaxhighlight>
|}

== Добавление расширений ==

Список всех уже установленных расширений можно увидеть на странице [[:Special:Version]] а в руссифицированных версиях также [[:Служебная:Version]]

Все расширения (extensions) устанавливаются в MediaWiki одинаково:
# копируются в свой подкаталог в каталоге extensions. Список расширений можно узнать из [http://www.mediawiki.org/wiki/Extension_Matrix официального списка].
# в '''LocalSettings.php''' добавляется строка:
<source lang="bash">
require_once( "$IP/extensions/Каталог_Расширения/Главный_Файл_Расширения.php" );
</source>

'''Некоторые полезные расширения'''

* [http://www.mediawiki.org/wiki/Extension:FCKeditor_%28Official%29 FCKeditor] - визуальный (WYSIWYG) редактор. У этого расширения можно обновить сам [http://ckeditor.com/download редактор]. Подключаем:
<source lang="bash">
require_once( "$IP/extensions/FCKeditor/FCKeditor.php" );
</source>

* [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite.php] - добавляет поддержку тэгов '''<nowiki><ref></nowiki>''' и '''<nowiki><references /></nowiki>''', что позволяет использовать в тексте статьи сноски. Подключаем:
<source lang="bash">
require_once( "$IP/extensions/Cite/Cite.php" );
</source>

* [http://www.mediawiki.org/wiki/Extension:ParserFunctions/ru ParserFunctions] - позволяет использовать тэги: '''<nowiki>#expr: #if: #ifeq: #ifexist: #ifexpr: #switch: #time: #rel2abs: #titleparts: #iferror:</nowiki>'''. На Википедии можно почитать как использовать [http://ru.wikipedia.org/wiki/Википедия:Функции_парсера функции парсера]. Устанавливать лучше из репозитория Subversion (скачать [http://subversion.apache.org/packages.html#windows клиент]):
<source lang="bash">
cd extensions/
svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/ParserFunctions
</source>

* [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi] - подсветка синтаксиса программного кода, позволяет использовать тэги '''<nowiki><syntaxhighlight> и <source></nowiki>'''. Это расширенная версия [http://www.mediawiki.org/wiki/Extension:Geshi GeSHi]

<source lang="bash">
cd extensions/
svn co svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi
</source>

Подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
</syntaxhighlight>

'''Параметры:'''

** '''lang'''="??": Определяет язык программировария, сказывается на самой подсветке
** '''line'''="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS": Как нумеровать линии (по умолчанию никак)
** '''line start'''="??": Какой номер у первой строки, используется вместе с line
** '''highlight'''="??": Какую линию подсветить, не зависит от line start
** '''enclose'''="??": В какой контейнер поместить блок. Принимает значения "pre" (по умолчанию), "div", "none".
** '''strict''': Присутствие этого параметра указывает, что нужно использовать режим strict.

* [http://www.mediawiki.org/wiki/Extension:CategoryTree CategoryTree] - добавляет более удобную навигацию по категориям. Позволяет использовать тэг <nowiki><categorytree></nowiki>

Копируем в каталог расширений и подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/CategoryTree/CategoryTree.php");
</syntaxhighlight>

* [http://www.mediawiki.org/wiki/Extension:Collection Collection] - даёт возможность создавать книги в формате PDF из статей сайта.

'''! Требует чтобы PHP поддерживал cURL !''' Возможно потребуется доуставить.

Копируем в каталог расширений и подключаем:

<syntaxhighlight lang=php>
require_once("$IP/extensions/Collection/Collection.php");
</syntaxhighlight>

Чтобы дать пользователям возможность сохранять и делиться своими книгами с другими, добавьте в Localsettings.php:

<syntaxhighlight lang=php>
$wgGroupPermissions['user']['collectionsaveasuserpage'] = true;
$wgGroupPermissions['user']['collectionsaveascommunitypage'] = true;
</syntaxhighlight>

С настройками по умолчанию книги будут генерироваться на сервере разработчика этого расширения.

* [http://www.mediawiki.org/wiki/Extension:CharInsert CharInsert] - быстрое добавление любых символов или шаблонных тегов. Ниже окна редактирования размещается дополнительная панель инструментов.

== Резервное копирование ==

Чтобы узнать, как скачать дампы базы данных со статьями Википедии, см. [http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Linux/ru статью Википедии]

Для создания собственного дампа локального сайта, использующего MediaWiki, есть [http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki/ru подробная инструкция].

Если кратко, то полная резервная копия - это дамп из СУБД (у меня MySQL) в виде SQL выражений, а частичная в виде xml файла. Особенности последней в том, что она не зависит от структуры базы данных и может быть перенесена, например, на нувую версию MediaWiki с изменнённой структурой БД, но в xml не выгружаются информация о логинаx пользователей, журналы и метаданные изображений.

*Для '''SQL''' дампа выполняем:
<source lang="mysql">
mysqldump -h $SERVER -u $USER -p$PASSWORD --default-character-set=$CHARSET $DATABASE -c \
| /bin/gzip -9 > ~/backup/wiki-$(date '+%a').sql.gz
</source>

:параметры '''$USER''', '''$PASSWORD''' и '''$DATABASE''' берём из LocalSettings.php
:<source lang="bash">cat ./LocalSettings.php | grep wgDB</source>

:параметр '''--default-character-set=$CHARSET''' нужен, если возникли проблемы с кодировкой (подробней см. статью выше)

:параметр '''-h $SERVER''' нужен если подключаемся не через сокет, иначе получим ошибку:
:<pre>mysqldump: Got error: 2002: Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) when trying to connect</pre>

*Для '''XML''' дампа используем скрипт [http://www.mediawiki.org/wiki/Manual:DumpBackup.php dumpBackup.php], расположенный в каталоге '''maintenance''':
<source lang="bash">
php maintenance\dumpBackup.php --full > full.xml</source>

Список параметров dumpBackup.php можно получить, вызвав его без параметров, однако, в исходном коде этого скрипта есть ещё несколько недокументированных опций.

== Редактировние статей ==

Об этом можно подробно узнать из [[Справка:Содержание|Справки по редактированию]].

== Уменьшение нагрузки ==

Полезно запретить поисковым роботам индексировать все служебные страницы, а ограничить их только статьями. Для этого редактируем файл '''robots.txt''' в корне сайта:

<source lang="bash">User-agent: *
Disallow: /w/</source>

В случае [[MediaWiki/Wiki_family_(farm)|вики семьи]] (фермы), в корневой каталог сайта кладём:

<source lang="bash"> User-agent: *
Disallow: /w/
Disallow: /ru/w-
Disallow: /en/w-
</source>
а в языковые подкаталоги:

<source lang="bash"> User-agent: *
Disallow: /w/
Disallow: /w-</source>

Подробнее см. на [http://www.mediawiki.org/wiki/Robots.txt официальном сайте]

==Дополнительные настройки==

* [http://www.mediawiki.org/wiki/Manual:Interwiki/ru Интервики] (interwiki) - это ссылки, оформленные как внутренние ссылки с использованием специального префикса, но ведущие на страницы других проектов. Интервики-ссылки позволяют сделать ссылку на страницы других вики-проектов, например Википедии, Викиучебника, Викиновостей и т.д., или, к примеру, на разделы вашего вики-проекта на разных языках.
** [http://www.mediawiki.org/wiki/Extension:Interwiki расширение Interwiki] позволяет редактировать таблицу интервики ссылок.

* [http://www.mediawiki.org/wiki/Manual:Tagline_(Site_Subtitle) Tagline] - можно изменить подпись "'''Материал из НазваниеВики'''".

== Полезные ссылки ==

'''Документация:'''
* http://meta.wikimedia.org/wiki/Помощь:Содержание
* http://ru.wikibooks.org/wiki/Вики - небольшой Викиучебник

'''Советы по настройке:'''
* http://ru.wikia.com/wiki/Настройка_вики
* http://docs.altlinux.org/archive/4.1/school_server/mediawiki/index.html
* http://homo-creativus.info/tag/mediawiki/

'''Справочники:'''
* http://www.wikireality.ru/wiki/Настройки_конфигурации_MediaWiki_(по_алфавиту) - описание всех параметров LocalSettings.php на русском языке

'''Скины:'''
* Инструкции как сделать свой скин
** на [http://wiki.auditory.ru/Создание_скинов_для_MediaWiki русском языке]
** на [http://www.siteground.com/tutorials/mediawiki/mediawiki_skins.htm английском]
** полная [http://www.mediawiki.org/wiki/Skinning официальная]

* Сайты со скинами
** http://mediawiki2u.com/

'''Утилиты:'''
* http://www.mediawiki.org/wiki/Extension:Word2MediaWikiPlus - Утилита для конвертации файлов MS Word 2007 в формат текста MediaWiki

'''Описание движка MediaWiki:'''
* http://www.mediawiki.org/wiki/Category:MediaWiki_database_tables - Таблицы
[[Category:Руководства]] [[Категория:Net]][[Категория:MediaWiki]]

Pipes: Программные каналы в Linux

2012-03-15T23:57:20Z

Langator:

== Предисловие ==

В одной остроумной статье я прочел следующую сентенцию: "Лишить приверженца Юникс программных каналов - то же самое, что отобрать мышь у пользователя Виндоуз". Возможно, в этом утверждении и есть некоторое преувеличение, но в прежние времена так оно, по большому счету, и было. Опытные сторонники Юниксовидных систем любят консоль и умеют ею пользоваться. Мы же, нынешние, установив Убунту, уже считаем себя линуксоидами, а что такое консоль, имеем смутное представления. Но проходит некоторое время, и, устав от украшения рабочего стола, прочитав две-три статейки, мы решаемся нажать мышкой на значок монитора в системном трее. Со временем перед нами открывается новый мир, полный удивительных возможностей и беспрерывного совершенствования своих знаний, мир пиршества интеллекта, непрекращающегося эксперимента, и радости оттого, что ты Homo Sapiens. Девиз: "Вернем радость в общение с компьютером!", - как нельзя лучше подходит для этого случая...

Предлагаемая вашему вниманию статья как раз для тех, кто недавно открыл для себя командную строку Линукс.

== Выбор термина ==

Термин pipe (труба) чрезвычайно органично вошел в англоязычный компьютерный жаргон. Этим словом называется не только способ передачи вывода одной команды на ввод другой, но и оператор, которым обозначается это действие: | (вертикальная черта). Кроме того, то же слово служит глаголом, означающим данное действие.

Какие только термины не используют в русском языке для перевода слова "pipes": и трубы, и трубопроводы, и конвейеры, и потоки, и прочее. В контексте все эти термины выглядят довольно неуклюже. И вот еще беда - ни от одного из этих существительных нельзя образовать глагол, не говоря уже о том, чтобы называть так символ вертикальной черты. Можно, правда, употребить глагол "конвейеризировать", но такое не написать, не выговорить невозможно. Я пытался делать наметки этой статьи, используя все перечисленные термины, но не был удовлетворен ни одним.

Совершенно случайно, в книге А. Робачевского "Операционная система UNIX" мне встретился термин "программные каналы". Поначалу он показался мне несколько громоздким, но попробовав его на деле, я убедился в его несомненных преимуществах. Он не выглядит смешно и дико как "трубы", от него легко произвести глагол, и, самое главное, он имеет вполне прижившегося на русской почве брата - "именованные каналы", которые никто не назовет "именованными трубопроводами". Итак, решено, в данной статье термин pipes будет звучать как "программные каналы".

== Введение в программные каналы ==

Программным каналом называется использование вывода одной команды в качестве ввода для другой программы. Например:

<source lang="bash">dmesg | less</source>

Команда dmesg выводит сообщения ядра Линукс о процессе загрузки ОС (те самые, что пробегают по экрану монитора при загрузке системы). Эти сообщения не умещаются на одном экране, и пролетают так быстро, что прочесть их невозможно. Поэтому вывод программы dmesg передают на ввод команде less. (Команда less позволяет выводу команды dmesg заполнить только один экран. Чтобы прочесть следующую порцию текста, нужно нажать клавишу пробела, а чтобы вернуться к предыдущей порции - клавишу b. Прервать работу программы можно клавишей q). Оператором такой передачи служит вертикальная черта (|). (Пробелы до и после вертикальной черты ставятся для удобства чтения, но можно обойтись и без них). Все вместе и есть простейший программный канал.

Того же результата можно достичь, если сначала перенаправить вывод команды dmesg во временный файл, а затем просмотреть содержимое этого файла на экране монитора.

<source lang="bash">dmesg > временный.файл
временный.файл > less</source>

Очевидно, что такая схема менее производительна: во-первых, необходимо давать две команды, во-вторых потому, что следующая команда может начать работать только после завершения первой.

Необходимо пояснить понятия, которые я походя назвал "вводом" и "выводом" программы.

Любая программа командной оболочки (шелла) оперирует с тремя потоками данных: стандартным вводом (stdin), стандартным выводом (stdout), и стандартным сообщением об ошибке (stderr). (Подробно об этом можно прочесть в статье "Перенаправление стандартных потоков данных").

По умолчанию, стандартный ввод осуществляется с клавиатуры, а стандартный вывод - на экран монитора. Если же мы задействуем оператор программных каналов (|), то стандартный вывод первой программы станет стандартным вводом второй, при этом на экране монитора он уже не появится.

Такая цепочка вовсе не ограничивается двумя программами, но может продолжаться сколь угодно долго.

== Как это работает ==

В большинстве Юниксовидных систем все процессы в программном канале начинаются одновременно, их потоки соответственно соединяются и управляются планировщиком вместе со всеми остальными процессами, идущими в системе.

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

Механизм этого свойства командной оболочки довольно сложен, в данной статье мы не станем его рассматривать, а будем просто пользоваться этой замечательной способностью шелла.

== Как пользоваться программными каналами ==

Чаще всего употребляются программные каналы, заканчивающиеся командами less и more. Эти две команды схожи по своему действию, однако less новее и имеет ряд дополнительных функций, включая возможность вернуться к предыдущим "страницам" вывода. Многие пользуются этими программными каналами, не подозревая, что занимаются столь мудреными вещами.

Кроме вышеприведенного примера с каналом dmesg | less, часто используется канал ls | less. Команда ls позволяет просматривать содержимое директорий, а с опцией -l дает подробные сведения о файлах, "населяющих" указанную директорию. Если директория содержит достаточно файлов, чтобы их список занял больше одного экрана, то применение программного канала с less или more неизбежно:

<source lang="bash">ls -l имя_директории | less</source>

или

<source lang="bash">ls -l имя_директории | more</source>

Для пробы проделайте такой пример:

<source lang="bash">ls -l -R /usr | less</source>

Только запаситесь терпением - на моей небольшой системе, установленной с одного CD, в выводе было 87 187 строк, сиречь файлов. Дело в том, что опция -R команды ls выводит содержимое директории рекурсивно, то есть открывая подкаталоги, подкаталоги подкаталогов и так далее, пока не перечислит все файлы. Правда, чтобы просмотреть действительно все файлы в директории, нужно войти как администратор (root), потому что некоторые каталоги могут не давать прав доступа рядовому пользователю.

Понятно, что найти "вручную" что-либо в таком списке проблематично, и тут на помощь снова придут программные каналы.

Команда grep найдет нужные вам строки, если вы зададите образец для поиска:

<source lang="bash">ls -l -R /usr | grep xorg.conf</source>
-rw-r--r-- 1 root root 16681 2008-08-25 23:21 xorg.conf.5.lzma

Обратите внимание на символ # в начале командной строки - он означает, что я вошел с правами суперпользователя.

Команды, входящие в состав программных каналов, часто называются командами-фильтрами, так как они пропускают через себя потоки данных.

Среди команд-фильтров самая употребительная, без сомнения, grep. Она применяется везде, где нужно выбрать искомое из большого объема данных. Скажем, просмотреть все, что касается USB в выводе команды dmesg:

$ dmesg | grep -i usb
usbcore: registered new interface driver usbfs
usbcore: registered new interface driver hub
usbcore: registered new device driver usb
ehci_hcd 0000:00:1a.7: new USB bus registered, assigned bus number 1
ehci_hcd 0000:00:1a.7: USB 2.0 started, EHCI 1.00, driver 10 Dec 2004
...

Это только начало списка строк, выведенных командой grep -i usb, я не привожу его полностью из экономии места. Опция -i приказывает команде grep не замечать разницы между заглавными и строчными буквами.

Любой системный администратор часто пользуется командой ps. С опциями -e и -f она выводит все процессы, текущие в системе в полной форме (подробно). Процессов этих весьма много, поэтому я не привожу полный вывод команды:

$ ps -ef
UID PID PPID C STIME TTY TIME CMD
root 1 0 0 13:58 ? 00:00:00 init [5]
root 2 0 0 13:58 ? 00:00:00 [kthreadd]
root 3 2 0 13:58 ? 00:00:00 [migration/0]
root 4 2 0 13:58 ? 00:00:00 [ksoftirqd/0]
...

Чтобы найти в этом списке интересующие вас процессы, следует канализировать команду ps с командой grep. Допустим, вас интересуют процессы hald:

$ ps -ef | grep hald
19 2457 1 0 13:58 ? 00:00:00 hald
root 2467 2457 0 13:58 ? 00:00:00 hald-runner
root 2824 2467 0 13:58 ? 00:00:00 /usr/lib/hald-addon-cpufreq
19 2825 2467 0 13:58 ? 00:00:00 hald-addon-acpi: listening on acpid socket /var/run/acpid.socket
root 2831 2467 0 13:58 ? 00:00:01 hald-addon-storage: polling /dev/sr0 (every 2 sec)
ya 2884 20820 0 14:49 pts/1 00:00:00 grep hald

С таким коротким списком уже легче работать. (Обратите внимание на последнюю строчку, там представлен сам запущенный нами процесс grep hald).

Другие распространенные команды-фильтры

Кроме команды grep (или вместе с ней) часто употребляются следующие команды:
* ''sort'' - сортирует строки по алфавиту или порядку номеров
* ''wc'' - подсчитывает количество строк, слов, байт или символов в тексте
* ''tr'' - заменяет одни символы другими
* ''sed'' - позволяет редактировать текст прямо из командной строки, даже не видя его.
* ''cut'' - вырезает из текста нужные куски и выдает их на стандартный вывод
* ''head/tail'' - позволяют ограничить просмотр первыми несколькими строками (head - голова), либо последними несколькими строками (tail - хвост).

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

== Сложные программные каналы ==

Вот пример, как наладить проверку орфографии, используя программные каналы. Допустим, что у вас есть файл words.txt, в котором содержатся все слова английского языка (разумеется, такого файла у вас нет, но можно позаимствовать список слов из какого-нибудь словаря; а английского - чтобы не путаться с кодировками). Тогда составляется следующий программный канал:

<source lang="bash"> $ wget "http://en.wikipedia.org/wiki/Pipeline_(Unix)" | \
sed 's/[^a-zA-Z ]/ /g' | \
tr 'A-Z ' 'a-z\n' | \
grep '[a-z]' | \
sort -u | \
comm -23 - words.txt</source>

'''''Примечание:''''' Символ (\) используется для объединения всех шести строк в одну командную строку.

Команда первая: wget получает содержимое HTML web страницы.

Команда вторая: sed удаляет из текста страницы все символы, не являющиеся пробелами или буквами и заменяет их пробелами.

Команда третья: tr переводит все символы верхнего регистра в нижний регистр (заглавные буквы в строчные), а также конвертирует пробелы в строках в символы новой строки, так что теперь каждое "слово" является новой строкой.

Команда четвертая: grep оставляет только строки, содержащие хотя бы один алфавитный символ (попросту букву), удаляя все пустые строки.

Команда пятая: sort сортирует список "слов" в алфавитном порядке, а с опцией -u удаляет дубликаты.

Команда шестая, и последняя: comm находит строки, общие для двух файлов. Первым файлом является стандартный вывод нашего программного канала, для чего вместо имени первого файла стоит прочерк (-), вторым файлом будет файл words.txt. Строки, которые встречаются только во втором файле и те, что встречаются в обоих файлах, подавляются опциями -2 и -3. Результатом будет список слов, встречающихся только в первом файле. И, если считать файл words.txt неким эталонным словарем, то выходящий список будет содержать слова, которых нет в словаре, то есть написанные с ошибками.

== Немного истории ==

Идею программных каналов и значок вертикальной черты как их обозначение придумал Douglas McIlroy, один из авторов ранних командных оболочек. Он обратил внимание на то, сколько времени уходит на обработку вывода одной программы в качестве ввода другой. Его идеи были внедрены в жизнь, когда в 1973 Ken Thompson добавил программные каналы в операционную систему Юникс. Идея была со временем позаимствована другими ОС, такими как DOS, OS/2, Microsoft Windows, и BeOS, часто даже с тем же обозначением.

== Понятие именованного канала ==

Английское название именованного канала - named pipe или FIFO (File In, File Out - файл пришел, файл ушел). Именованные каналы служат в основном для межпроцессного взаимодействия, когда различные процессы в системе обмениваются информацией. Тема это сложная и большая, заслуживающая отдельной статьи. Поэтому в данной работе я только вкратце коснусь ее.

В отличие от анонимного программного канала, автоматически создаваемого шеллом, именованный канал обладает именем, и создается явно при помощи команд mknod или mkfifo. Создадим именованный канал fifo1:

<source lang="bash">mkfifo fifo1</source>

Теперь запустим процесс, обращающийся к данному каналу:

<source lang="bash">grep fs < fifo1</source>

Несмотря на нажатие клавиши ENTER ничего не происходит, что не удивительно, ведь файл fifo1 пока пуст, и команде grep нечего обрабатывать. Однако консоль оказывается занята ждущим процессом, и разблокировать ее можно только прервав процесс (скажем, нажатием клавиш CTRL+c).

Чтобы наполнить именной канал содержимым, нужно чтобы к нему обратился второй процесс. Для этого мы должны открыть вторую консоль и запустить какую-либо команду, передающую данные в файл fifo1. Например:

(Другая консоль) <source lang="bash">ls /etc > fifo1</source>

Немедленно в первой консоли сработает команда grep:

grep fs < fifo1
fstab
gettydefs
login.defs
mke2fs.conf

Совершенно ясно, что пользоваться таким неудобным механизмом в пользовательских целях никто не будет, ведь гораздо проще запустить один программный канал:

<source lang="bash">ls /etc | grep fs</source>

и получить тот же результат.

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

== Резюме ==

Программные каналы - мощнейший инструмент Юниксовидных операционных систем. Создание программных каналов многократно ускоряет процесс обработки данных, сокращает количество "писанины" в командной строке, а также позволяет получать результат в наиболее удобном виде.

== Ссылки ==
[http://open-club.ru/main/reading/Pipes_%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D1%8B%D0%B5_%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B_%D0%B2_Linux open-club.ru]

[[Категория:Man]]

Звуковые сигналы BIOS

2012-03-15T23:56:30Z

Langator:

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

== Таблицы звуковых сигналов ==

=== IBM BIOS ===

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1 короткий
| Успешный [[POST|POST]]
|-
| 1 сигнал и пустой экран
| Неисправна видеосистема
|-
| 2 коротких
| Неисправна видеосистема (не подключен монитор)
|-
| 3 длинных
| Неисправна материнская плата (ошибка контроллера клавиатуры)
|-
| 1 длинный, 1 короткий
| Неисправна материнская плата
|-
| 1 длинный, 2 коротких
| Неисправна видеосистема (Mono/CGA)
|-
| 1 длинный, 3 коротких
| Неисправна видеосистема (EGA/VGA)
|-
| Повторяющийся короткий
| Неисправности связаны с блоком питания
|-
| Непрерывный
| Проблемы с блоком питания
|-
| Отсутствует
| Неисправен блок питания
|}

=== Award BIOS ===

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1 короткий
| Успешный [[POST|POST]]
|-
| 2 коротких
| Обнаружены незначительные ошибки. На экране монитора появляется предложение войти в программу CMOS Setup Utility и исправить ситуацию. Проверьте надежность крепления шлейфов в разъемах жесткого диска и материнской платы.
|-
| 3 длинных
| Ошибка контроллера клавиатуры
|-
| 1 короткий, 1 длинный
| Ошибка оперативной памяти (RAM)
|-
| 1 длинный, 2 коротких
| Ошибка видеокарты
|-
| 1 длинный, 3 коротких
| Ошибка при инициализации клавиатуры или Ошибка видеокарты
|-
| 1 длинный, 9 коротких
| Ошибка при чтении из ПЗУ
|-
| Повторяющийся короткий
| Проблемы с блоком питания
|-
| Повторяющийся длинный
| Проблемы с ОЗУ
|-
| Повторяющаяся высокая-низкая частота
| Проблемы с CPU
|-
| Непрерывный
| Проблемы с блоком питания
|}

=== AMI BIOS ===

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1 короткий
| Ошибок не обнаружено, ПК исправен
|-
| 1 длинный, 1 короткий
| Проблемы с блоком питания
|-
| 2 коротких
| Ошибка чётности RAM или вы забыли выключить Сканер или Принтер
|-
| 3 коротких
| Ошибка в первых 64 КБ RAM
|-
| 4 коротких
| Неисправность системного таймера
|-
| 5 коротких
| Проблемы с процессором
|-
| 6 коротких
| Ошибка инициализации контроллера клавиатуры
|-
| 7 коротких
| Проблемы с материнской платой
|-
| 8 коротких
| Ошибка памяти видеокарты
|-
| 9 коротких
| Контрольная сумма BIOS неверна
|-
| 10 коротких
| Ошибка записи в CMOS
|-
| 11 коротких
| Ошибка Кэша, расположенного на системной плате
|-
| 1 длинный, 2 коротких
| Ошибка видеокарты (Mono-CGA)
|-
| 1 длинный, 3 коротких
| Ошибка видеокарты (EGA-VGA)
|-
| 1 длинный, 8 коротких
| Проблемы с видеокартой или не подключён монитор
|-
| Отсутствует
| Неисправен Процессор. Возможно изогнут контакт микросхемы. Если не помогло, замените процессор.
|}

=== AST BIOS ===

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1 короткий
| Ошибка при проверке регистров Процессора. Неисправность Процессора
|-
| 2 коротких
| Ошибка буфера клавиатурного контроллера. Неисправность клавиатурного контроллера.
|-
| 3 коротких
| Ошибка сброса клавиатурного контроллера. Неисправность клавиатурного контроллера или системной платы.
|-
| 4 коротких
| Ошибка связи с клавиатурой.
|-
| 5 коротких
| Ошибка клавиатурного ввода.
|-
| 6 коротких
| Ошибка системной платы.
|-
| 9 коротких
| Несовпадение контрольной суммы ПЗУ BIOS. Неисправна микросхема ПЗУ BIOS.
|-
| 10 коротких
| Ошибка системного таймера. Системная Микросхема таймера неисправна.
|-
| 11 коротких
| Ошибка чипсета.
|-
| 12 коротких
| Ошибка регистра управления питанием в энергонезависимой памяти.
|-
| 1 длинный
| Ошибка контроллера DMA 0. Неисправна Микросхема контроллера DMA канала 0.
|-
| 1 длинный, 1 короткий
| Ошибка контроллера DMA 1. Неисправна микросхема контроллера DMA канала 1.
|-
| 1 длинный, 2 коротких
| Ошибка гашения обратного хода кадровой развёртки. Возможно, неисправен видеоадаптер.
|-
| 1 длинный, 3 коротких
| Ошибка в видеопамяти. Неисправна память видеоадаптера.
|-
| 1 длинный, 4 коротких
| Ошибка видеоадаптера. Неисправен видеоадаптер.
|-
| 1 длинный, 5 коротких
| Ошибка памяти 64K.
|-
| 1 длинный, 6 коротких
| Не удалось загрузить векторы прерываний. BIOS не смог загрузить векторы прерываний в память
|-
| 1 длинный, 7 коротких
| Не удалось инициализировать видеооборудование.
|-
| 1 длинный, 8 коротких
| Ошибка видеопамяти.
|}

=== Phoenix BIOS ===

Beep-коды представлены в количестве звуковых сигналов. Например, 1-1-2 означает 1 звуковой сигнал, пауза, 1 звуковой сигнал, пауза, и 2 звуковых сигнала.

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1-1-2
|-
| 1-1-3
| Ошибка записи/чтения данных в/из CMOS-памяти.
|-
| 1-1-4
| Обнаружена ошибка при подсчете контрольной суммы содержимого BIOS.
|-
| 1-2-1
| Ошибка инициализации материнской платы.
|-
| 1-2-2 или 1-2-3
| Ошибка инициализации контроллера DMA.
|-
| 1-3-1
| Ошибка инициализации схемы регенерации оперативной памяти.
|-
| 1-3-3 или 1-3-4
| Ошибка инициализации первых 64 Кбайт оперативной памяти.
|-
| 1-4-1
| Ошибка инициализации материнской платы.
|-
| 1-4-2
| Ошибка инициализации оперативной памяти.
|-
| 1-4-3
| Ошибка инициализации системного таймера.
|-
| 1-4-4
| Ошибка записи/чтения в/из одного из портов ввода/вывода.
|-
| 2-1-1
| Обнаружена ошибка при чтении/записи 0-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-1-2
| Обнаружена ошибка при чтении/записи 1-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-1-3
| Обнаружена ошибка при чтении/записи 2-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-1-4
| Обнаружена ошибка при чтении/записи 3-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-2-1
| Обнаружена ошибка при чтении/записи 4-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-2-2
| Обнаружена ошибка при чтении/записи 5-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-2-3
| Обнаружена ошибка при чтении/записи 6-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-2-4
| Обнаружена ошибка при чтении/записи 7-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-3-1
| Обнаружена ошибка при чтении/записи 8-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-3-2
| Обнаружена ошибка при чтении/записи 9-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-3-3
| Обнаружена ошибка при чтении/записи 10-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-3-4
| Обнаружена ошибка при чтении/записи 11-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-4-1
| Обнаружена ошибка при чтении/записи 12-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-4-2
| Обнаружена ошибка при чтении/записи 13-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-4-3
| Обнаружена ошибка при чтении/записи 14-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 2-4-4
| Обнаружена ошибка при чтении/записи 15-го бита (в шестнадцатеричном представлении) первых 64 Кбайт ОЗУ
|-
| 3-1-1
| Ошибка инициализации второго канала DMA.
|-
| 3-1-2 или 3-1-4
| Ошибка инициализации первого канала DMA.
|-
| 3-2-4
| Ошибка инициализации контроллера клавиатуры.
|-
| 3-3-4
| Ошибка инициализации видеопамяти.
|-
| 3-4-1
| Возникли серьёзные проблемы при попытке обращения к монитору.
|-
| 3-4-2
| Не удается инициализировать BIOS видеоплаты.
|-
| 4-2-1
| Ошибка инициализации системного таймера.
|-
| 4-2-2
| Тестирование завершено.
|-
| 4-2-3
| Ошибка инициализации контроллера клавиатуры.
|-
| 4-2-4
| Критическая ошибка при переходе центрального процессора в защищенный режим.
|-
| 4-3-1
| Ошибка инициализации оперативной памяти.
|-
| 4-3-2
| Ошибка инициализации первого таймера.
|-
| 4-3-3
| Ошибка инициализации второго таймера.
|-
| 4-4-1
| Ошибка инициализации одного из последовательных портов.
|-
| 4-4-2
| Ошибка инициализации параллельного порта.
|-
| 4-4-3
| Ошибка инициализации математического сопроцессора.
|-
| Длинные, непрекращающиеся сигналы
| Неисправна материнская плата.
|-
| Звук сирены с высокого на низкую частоту
| Неисправна видеокарта, проверить электролитические емкости, на утечку или заменить все на новые заведомо исправные.
|-
| Непрерывный сигнал
| Неподключен (неисправен) кулер CPU.
|}

=== Compaq BIOS ===

{| class="wikitable"
|-
! Звуки
! Описание
|-
| 1 короткий
| Ошибок нет. Нормальная загрузка системы.
|-
| 1 длинный + 1 короткий
| Ошибка контрольной суммы памяти CMOS BIOS. Возможно сел аккумулятор ROM.
|-
| 2 короткий
| Глобальная ошибка. (Epic Fail)
|-
| 1 длинный + 2 короткий
| Ошибка инициализации видеокарты. Проверьте правильность установки видеокарты.
|-
| 7 сигналов (1 длинный, 1 с, 1?, 1 короткий, пауза, 1 длинный, 1 короткий, 1 короткий)
| Неисправность видеокарты AGP. Проверьте правильность установки.
|-
| 1 длинный постоянный
| Ошибка оперативной памяти, попробуйте перезагрузиться.
|-
| 1 короткий + 2 длинных
| Неисправность оперативной памяти. Перезагрузитесь через Reset.
|}

=== DELL BIOS ===

Beep-коды представлены в количестве звуковых сигналов. Например, 1-1-2 означает 1 звуковой сигнал, пауза, 1 звуковой сигнал, пауза, и 2 звуковых сигнала.

{| class="wikitable"
|-
! Последовательность звуковых сигналов
! Описание ошибки
|-
| 1-2
| Не подключена видеокарта
|-
| 1-2-2-3
| Ошибка контрольной суммы ПЗУ BIOS
|-
| 1-3-1-1
| Ошибка обновления DRAM
|-
| 1-3-1-3
| Ошибка клавиатуры 8742
|-
| 1-3-3-1
| Неисправна память
|-
| 1-3-4-1
| Ошибка ОЗУ на линии xxx
|-
| 1-3-4-3
| Ошибка ОЗУ на младшем бите xxx
|-
| 1-4-1-1
| Ошибка ОЗУ на старшем бите xxx
|}

== См. также ==

*[[POST|POST]]

== Ссылки ==

*[http://www.ixbt.com/mainboard/faq/biosfaq.shtml#q16 Часто задаваемые вопросы о BIOS]
*[http://www.umopit.ru/CompLab/BIOSbeeps.htm Звуковые коды сообщений BIOS разных производителей]
*[http://bios-master.ru/ Все о BIOS и его настройке]
*[http://icbook.com.ua/post/_amibeep/amibios8_bootblock_beep_codes.html Звуковые сообщения загрузочного блока AMIBIOS8]
*[http://icbook.com.ua/post/_amibeep/amibios8_post_beep_codes.html Звуковые сообщения AMIBIOS8 POST]

[[Категория:BIOS]]

POST

2012-03-15T23:55:23Z

Langator:

'''POST''' ({{lang-en|Power-On Self-Test}}) — самотестирование после включения. Проверка аппаратного обеспечения компьютера, выполняемая при его включении. Выполняется программами, входящими в BIOS материнской платы.

Сокращённый тест включает:
# Проверку целостности программ BIOS в ПЗУ, используя контрольную сумму.
# Обнаружение и инициализацию основных контроллеров, системных шин и подключенных устройств (графического адаптера, контроллеров дисководов и т. п.), а также выполнение программ, входящих в BIOS устройств и обеспечивающих их самоинициализацию.
# Определение размера оперативной памяти и тестирования первого сегмента (64 килобайт).

Полный регламент работы POST:
# Проверка регистров процессора;
# Проверка контрольной суммы ПЗУ;
# Проверка системного таймера и порта звуковой сигнализации (для IBM PC — ИМС i8255 или аналог);
# Тест контроллера прямого доступа к памяти;
# Тест регенератора оперативной памяти;
# Тест нижней области ОЗУ для проецирования резидентных программ в BIOS;
# Загрузка резидентных программ;
# Тест стандартного графического адаптера (VGA);
# Тест оперативной памяти;
# Тест основных устройств ввода (НЕ манипуляторов);
# Тест CMOS
# Тест основных портов LPT/COM;
# Тест накопителей на гибких магнитных дисках (НГМД);
# Тест накопителей на жёстких магнитных дисках (НЖМД);
# Самодиагностика функциональных подсистем BIOS;
# Передача управления загрузчику.

Выбор между прохождением полного или сокращенного набора тестов при включении компьютера можно задать в программе настройки базовой системы ввода-вывода, Setup BIOS.

В большинстве персональных компьютеров в случае успешного прохождения POST системный динамик издаёт один короткий звуковой сигнал, в случае сбоя — различные последовательности звуковых сигналов.
Кроме того, BIOS генерирует код текущего состояния загрузки (и, в случае сбоя, соответственно ошибки), который можно узнать при помощи комбинации светодиодов или семисегментных индикаторов (на некоторых материнских платах), а также на POST Card — плате, которая вставляется в слот расширения и отображает код ошибки.

Сопоставить конкретный звуковой код, текстовое сообщение на мониторе или код POST с причиной сбоя во время загрузки компьютера можно по документации производителя BIOS, обычно материнской платы или дополнительной платы контроллера устройства.

== См. также ==
* [[Звуковые сигналы BIOS]]

== Ссылки ==
* [http://bios-master.ru/ Все о BIOS и его настройке]
* [http://icbook.com.ua/post/_award6/iboot.html Post коды Award BIOS 6.0 Medallion]
* [http://icbook.com.ua/post/_phoenix/index.html Post коды Phoenix BIOS]
* [http://www.intel.com/support/ru/motherboards/desktop/sb/CS-025434.htm Системные платы для настольных ПК Intel]

[[Категория:BIOS]]

Bash

2012-03-15T23:53:16Z

Langator: /* Особенности */

{{Infobox software
| name = Bash
| logo =
| screenshot = [[Image:Bash demo.png|250px]]
| caption = Изображение bash и sh сессии
| author = Brian Fox
| released = {{start date and age|1989|6|7}}
| frequently updated = yes
| programming language = Cи
| operating system = Cross-platform
| platform = GNU
| language = English, multilingual
| status = Active
| genre = Unix shell
| source model = Free software
| license = GPLv3
| website = [http://www.gnu.org/software/bash/ Bash GNU project home page]
}}

'''Bash''' - это ''POSIX shell'' написанный в рамках проекта GNU. Является самым распространенным командным интерпретатором, используется по умолчанию в подавляющем количестве дистрибутивов GNU/Linux.

'''Bash''' — это акроним от ''Bourne-again-shell'', «ещё-одна-командная-оболочка-Борна». Название — игра слов: Bourne-shell — одна из популярных разновидностей командной оболочки для UNIX (sh), автором которой является Стивен Борн (1978), усовершенствована в 1987 году Брайаном Фоксом. Фамилия Bourne (Борн) перекликается с английским словом born, означающим «родившийся», отсюда: рождённая-вновь-командная оболочка.

==Особенности==
Синтаксис bash является расширенным вариантом синтаксиса Bourne shell (часто просто sh по имени исполняемого файла). Подавляющее большинство скриптов sh могут выполняться bash`ем без изменений. Bash включает в себя идеи ksh и csh такие как история команд, редактор командной строки, переменные <tt>$RANDOM</tt>, <tt>$PPID</tt> и <tt>$(…)</tt>. При использовании в качестве интерактивной оболочки и двойном нажатии клавиши tab происходит автоматическое дополнение команд, имен файлов и переменных.

Bash имеет много возможностей, которых не хватает в Bourne shell. Например, bash может выполнять вычисления с целыми числами без порождения внешних процессов. Bash упрощает перенаправление ввода/вывода способами, которые невозможны в традиционных шелах Борна. Например, Bash может перенаправить стандартный вывод (STDOUT) и стандартная ошибка (STDERR) используя оператор <tt>&></tt>. Это проще напечатать, чем эквивалентная команда в Bourne Shell.
<source lang="bash">command > file 2>&1</source>

При использовании функций (function) bash не совместим с Bourne/Korn/POSIX шелами, но понимает их синтаксис. В силу этих и других различий, bash скрипты редко работоспособной под sh и ksh, если намеренно написаны с совместимостью. Но в режиме POSIX, соответствие POSIX является почти идеальным.

С версии 2.05b bash может перенаправлять стандартный ввод (stdin) используя оператор <tt>'''<'''</tt>.

В bash 3.0 появилась поддержка регулярных выражений Perl.

Bash 4.0 поддержка массивов аналогичных awk:

<source lang="bash">
declare -A a # declare an associative array 'a'
i=1; j=2 # initialize some indices
a[$i,$j]=5 # associate value "5" to key "$i,$j" (i.e. "1,2")
echo ${a[$i,$j]} # print the stored value at key "$i,$j"
</source>

===Выражения со скобками===

Выражения со скобками, которые также называются чередованием, были скопированы из C shell и генерирует набор различных комбинаций. Строки не сортируются и обрабатываются в порядке слева направо:

<source lang="bash">
echo a{p,c,d,b}e # ape ace ade abe
echo {a,b,c}{d,e,f} # ad ae af bd be bf cd ce cf
</source>

Чередование не должно использоваться в портативных скриптах, т.к. Bourne shell его не поддерживает.

<source lang="bash">
echo a{p,c,d,b}e # a{p,c,d,b}e
</source>

Когда чередование комбинируется со знаками подстановки, первым используется чередование, а затем символы заменяются в обычном режиме. Таким образом, список JPEG и PNG изображений в текущей директории может быть получен так:

<source lang="bash">
ls *.{jpg,jpeg,png} # заменяется на *.jpg *.jpeg *.png - после чего обрабатываются шаблоны
</source>

===Стартовые скрипты===

Bash при запуске вызывает множество команд и различных скриптов.
Когда Bash вызывается как интерактивная оболочка, первым делом он читает и вызывает команды из файла {{Path|/etc/profile}}. После чтения этого выполняются следующие файлы: {{Path|~/.bash_profile}}, {{Path|~/.bash_login}}, и {{Path|~/.profile}}. При выходе Bash выполняет команды из файла {{Path|~/.bash_logout}}.
Также Bash использует файл {{Path|~/.bashrc}}. Это может быть отменено опцией ''--norc''. Опция ''--rcfile'' заставит Bash использовать команды из {{Path|~/.bashrc}}.

==Комбинации клавиш==
{{Key|'''ctrl+u'''}} удалить все символы от курсора до начала строки

{{Key|'''ctrl+k'''}} удалить все символы от курсора до конца строки

{{Key|'''ctrl+w'''}} удалить слово перед курсором

{{Key|'''ctrl+b'''}} переместить курсор на один символ влево

{{Key|'''ctrl+f'''}} переместить курсор на один символ вправо

{{Key|'''ctrl+t'''}} поменять местами символ слева от курсора и под курсором

{{Key|'''ctrl+h'''}} удалить символ слева от курсора

{{Key|'''ctrl+a'''}} переместить курсор в начало строки

{{Key|'''ctrl+e'''}} переместить курсор в конец строки

{{Key|'''ctrl+p'''}} предыдущая команда в истории bash

{{Key|'''ctrl+n'''}} следующая команда в истории bash

{{Key|'''ctrl+r'''}} реверсивный поиск команд в истории bash

{{Key|'''ctrl+y'''}} вставляет последнюю удаленную с помощью ctrl+u или ctrl+k строку

{{Key|'''ctrl+m'''}} выполнение команды, аналог [Enter]

{{Key|'''ctrl+o'''}} выполняет команду, при этом оставляя ее в командной строке для дальнейшего использования.

{{Key|'''ctrl+l'''}} очистить экран

{{Key|'''ctrl+s'''}} стоп режим. Блокирует вывод на консоль. При этом все данные отображенные на экране остаются не измененными.

{{Key|'''Tab+Tab'''}} выводит список команд. При наличии какого нибудь символа(-ов) выводит команды по введенным символам.

{{Key|'''ctrl+q'''}} выход из стоп-режима.

{{Key|'''ctrl+d'''}} выйти из терминала

{{Key|'''ctrl+c'''}} отменить последнюю введенную команду

{{Key|'''ctrl+x,ctrl+v'''}} показать версию bash

== Ссылки ==

[http://wiki.opennet.ru/Bash Bash]

Bash

2012-03-15T23:51:34Z

Langator:

{{Infobox software
| name = Bash
| logo =
| screenshot = [[Image:Bash demo.png|250px]]
| caption = Изображение bash и sh сессии
| author = Brian Fox
| released = {{start date and age|1989|6|7}}
| frequently updated = yes
| programming language = Cи
| operating system = Cross-platform
| platform = GNU
| language = English, multilingual
| status = Active
| genre = Unix shell
| source model = Free software
| license = GPLv3
| website = [http://www.gnu.org/software/bash/ Bash GNU project home page]
}}

'''Bash''' - это ''POSIX shell'' написанный в рамках проекта GNU. Является самым распространенным командным интерпретатором, используется по умолчанию в подавляющем количестве дистрибутивов GNU/Linux.

'''Bash''' — это акроним от ''Bourne-again-shell'', «ещё-одна-командная-оболочка-Борна». Название — игра слов: Bourne-shell — одна из популярных разновидностей командной оболочки для UNIX (sh), автором которой является Стивен Борн (1978), усовершенствована в 1987 году Брайаном Фоксом. Фамилия Bourne (Борн) перекликается с английским словом born, означающим «родившийся», отсюда: рождённая-вновь-командная оболочка.

==Особенности==
Синтаксис bash является расширенным вариантом синтаксиса Bourne shell (часто просто sh по имени исполняемого файла). Подавляющее большинство скриптов sh могут выполняться bash`ем без изменений. Bash включает в себя идеи ksh и csh такие как история команд, редактор командной строки, переменные <tt>$RANDOM</tt>, <tt>$PPID</tt> и <tt>$(…)</tt>. При использовании в качестве интерактивной оболочки и двойном нажатии клавиши tab происходит автоматическое дополнение команд, имен файлов и переменных.

Bash имеет много возможностей, которых не хватает в Bourne shell. Например, bash может выполнять вычисления с целыми числами без порождения внешних процессов. Bash упрощает перенаправление ввода/вывода способами, которые невозможны в традиционных шелах Борна. Например, Bash может перенаправить стандартный вывод (STDOUT) и стандартная ошибка (STDERR) используя оператор <tt>&></tt>. Это проще напечатать, чем эквивалентная команда в Bourne Shell.
<source lang="bash">command > file 2>&1</source>

При использовании функций (function) bash не совместим с Bourne/Korn/POSIX шелами, но понимает их синтаксис. В силу этих и других различий, bash скрипты редко работоспособной под sh и ksh, если намеренно написаны с совместимостью. Но в режиме POSIX, соответствие POSIX является почти идеальным.

С версии 2.05b bash может перенаправлять стандартный ввод (stdin) используя the <tt><</tt> оператор.

В bash 3.0 появилась поддержка регулярных выражений Perl.

Bash 4.0 поддержка массивов аналогичных awk:

<source lang="bash">
declare -A a # declare an associative array 'a'
i=1; j=2 # initialize some indices
a[$i,$j]=5 # associate value "5" to key "$i,$j" (i.e. "1,2")
echo ${a[$i,$j]} # print the stored value at key "$i,$j"
</source>

===Выражения со скобками===

Выражения со скобками, которые также называются чередованием, были скопированы из C shell и генерирует набор различных комбинаций. Строки не сортируются и обрабатываются в порядке слева направо:

<source lang="bash">
echo a{p,c,d,b}e # ape ace ade abe
echo {a,b,c}{d,e,f} # ad ae af bd be bf cd ce cf
</source>

Чередование не должно использоваться в портативных скриптах, т.к. Bourne shell его не поддерживает.

<source lang="bash">
echo a{p,c,d,b}e # a{p,c,d,b}e
</source>

Когда чередование комбинируется со знаками подстановки, первым используется чередование, а затем символы заменяются в обычном режиме. Таким образом, список JPEG и PNG изображений в текущей директории может быть получен так:

<source lang="bash">
ls *.{jpg,jpeg,png} # заменяется на *.jpg *.jpeg *.png - после чего обрабатываются шаблоны
</source>

===Стартовые скрипты===

Bash при запуске вызывает множество команд и различных скриптов.
Когда Bash вызывается как интерактивная оболочка, первым делом он читает и вызывает команды из файла {{Path|/etc/profile}}. После чтения этого выполняются следующие файлы: {{Path|~/.bash_profile}}, {{Path|~/.bash_login}}, и {{Path|~/.profile}}. При выходе Bash выполняет команды из файла {{Path|~/.bash_logout}}.
Также Bash использует файл {{Path|~/.bashrc}}. Это может быть отменено опцией ''--norc''. Опция ''--rcfile'' заставит Bash использовать команды из {{Path|~/.bashrc}}.

==Комбинации клавиш==
{{Key|'''ctrl+u'''}} удалить все символы от курсора до начала строки

{{Key|'''ctrl+k'''}} удалить все символы от курсора до конца строки

{{Key|'''ctrl+w'''}} удалить слово перед курсором

{{Key|'''ctrl+b'''}} переместить курсор на один символ влево

{{Key|'''ctrl+f'''}} переместить курсор на один символ вправо

{{Key|'''ctrl+t'''}} поменять местами символ слева от курсора и под курсором

{{Key|'''ctrl+h'''}} удалить символ слева от курсора

{{Key|'''ctrl+a'''}} переместить курсор в начало строки

{{Key|'''ctrl+e'''}} переместить курсор в конец строки

{{Key|'''ctrl+p'''}} предыдущая команда в истории bash

{{Key|'''ctrl+n'''}} следующая команда в истории bash

{{Key|'''ctrl+r'''}} реверсивный поиск команд в истории bash

{{Key|'''ctrl+y'''}} вставляет последнюю удаленную с помощью ctrl+u или ctrl+k строку

{{Key|'''ctrl+m'''}} выполнение команды, аналог [Enter]

{{Key|'''ctrl+o'''}} выполняет команду, при этом оставляя ее в командной строке для дальнейшего использования.

{{Key|'''ctrl+l'''}} очистить экран

{{Key|'''ctrl+s'''}} стоп режим. Блокирует вывод на консоль. При этом все данные отображенные на экране остаются не измененными.

{{Key|'''Tab+Tab'''}} выводит список команд. При наличии какого нибудь символа(-ов) выводит команды по введенным символам.

{{Key|'''ctrl+q'''}} выход из стоп-режима.

{{Key|'''ctrl+d'''}} выйти из терминала

{{Key|'''ctrl+c'''}} отменить последнюю введенную команду

{{Key|'''ctrl+x,ctrl+v'''}} показать версию bash

== Ссылки ==

[http://wiki.opennet.ru/Bash Bash]

Bash

2012-03-15T23:38:32Z

Langator: /* Features */

{{Infobox software
| name = Bash
| logo =
| screenshot = [[Image:Bash demo.png|250px]]
| caption = Изображение bash и sh сессии
| author = Brian Fox
| released = {{start date and age|1989|6|7}}
| frequently updated = yes
| programming language = Cи
| operating system = Cross-platform
| platform = GNU
| language = English, multilingual
| status = Active
| genre = Unix shell
| source model = Free software
| license = GPLv3
| website = [http://www.gnu.org/software/bash/ Bash GNU project home page]
}}

'''Bash''' - это ''POSIX shell'' написанный в рамках проекта GNU. Является самым распространенным командным интерпретатором, используется по умолчанию в подавляющем количестве дистрибутивов GNU/Linux.

'''Bash''' — это акроним от ''Bourne-again-shell'', «ещё-одна-командная-оболочка-Борна». Название — игра слов: Bourne-shell — одна из популярных разновидностей командной оболочки для UNIX (sh), автором которой является Стивен Борн (1978), усовершенствована в 1987 году Брайаном Фоксом. Фамилия Bourne (Борн) перекликается с английским словом born, означающим «родившийся», отсюда: рождённая-вновь-командная оболочка.

== История ==

Фокс начал разработку Bash 10 января 1988 года, после того как Ричард Столлман стал недоволен отсутствием прогресса в разработке. Фокс выпустил первую бета-версию bash 0,99 7 июня 1989 года и был главным разработчиком с середины 1992 до середины 1994 года, затем был уволен из FSF и его место занял Чет Рамей.

==Особенности==
Синтаксис bash является расширенным вариантом синтаксиса Bourne shell (часто просто sh по имени исполняемого файла). Подавляющее большинство скриптов sh могут выполняться bash`ем без изменений. Bash включает в себя идеи ksh и csh такие как история команд, редактор командной строки, переменные <tt>$RANDOM</tt>, <tt>$PPID</tt> и <tt>$(…)</tt>. При использовании в качестве интерактивной оболочки и двойном нажатии клавиши tab происходит автоматическое дополнение команд, имен файлов и переменных.

Bash имеет много возможностей, которых не хватает в Bourne shell. Например, bash может выполнять вычисления с целыми числами без порождения внешних процессов. Bash упрощает перенаправление ввода/вывода способами, которые невозможны в традиционных шелах Борна. Например, Bash может перенаправить стандартный вывод (STDOUT) и стандартная ошибка (STDERR) используя оператор <tt>&></tt>. Это проще напечатать, чем эквивалентная команда в Bourne Shell.
<source lang="bash">command > file 2>&1</source>

При использовании функций (function) bash не совместим с Bourne/Korn/POSIX шелами, но понимает их синтаксис. В силу этих и других различий, bash скрипты редко работоспособной под sh и ksh, если намеренно написаны с совместимостью. Но в режиме POSIX, соответствие POSIX является почти идеальным.

С версии 2.05b bash может перенаправлять стандартный ввод (stdin) используя the <tt><</tt> оператор.

В bash 3.0 появилась поддержка регулярных выражений Perl.

Bash 4.0 поддержка массивов аналогичных awk:

<source lang="bash">
declare -A a # declare an associative array 'a'
i=1; j=2 # initialize some indices
a[$i,$j]=5 # associate value "5" to key "$i,$j" (i.e. "1,2")
echo ${a[$i,$j]} # print the stored value at key "$i,$j"
</source>

===Выражения со скобками===

Выражения со скобками, которые также называются чередованием, были скопированы из C shell и генерирует набор различных комбинаций. Строки не сортируются и обрабатываются в порядке слева направо:

<source lang="bash">
echo a{p,c,d,b}e # ape ace ade abe
echo {a,b,c}{d,e,f} # ad ae af bd be bf cd ce cf
</source>

Чередование не должно использоваться в портативных скриптах, т.к. Bourne shell его не поддерживает.

<source lang="bash">
echo a{p,c,d,b}e # a{p,c,d,b}e
</source>

Когда чередование комбинируется со знаками подстановки, первым используется чередование, а затем символы заменяются в обычном режиме. Таким образом, список JPEG и PNG изображений в текущей директории может быть получен так:

<source lang="bash">
ls *.{jpg,jpeg,png} # заменяется на *.jpg *.jpeg *.png - после чего обрабатываются шаблоны
</source>

===Стартовые скрипты===

Bash при запуске вызывает множество команд и различных скриптов.
Когда Bash вызывается как интерактивная оболочка, первым делом он читает и вызывает команды из файла {{Path|/etc/profile}}. После чтения этого файла, он смотрит следующие файлы в данном порядке: {{Path|~/.bash_profile}}, {{Path|~/.bash_login}}, и {{Path|~/.profile}}, читает и вызывает команды из них. При выходе Bash читает и выполняет команды из файла {{Path|~/.bash_logout}}.
Также Bash использует команды из файла {{Path|~/.bashrc}}. Это может быть отменено опцией ''--norc''. Опция ''--rcfile'' заставит Bash использовать команды из {{Path|~/.bashrc}}.

==Комбинации клавиш==
{{Key|'''ctrl+u'''}} удалить все символы от курсора до начала строки

{{Key|'''ctrl+k'''}} удалить все символы от курсора до конца строки

{{Key|'''ctrl+w'''}} удалить слово перед курсором

{{Key|'''ctrl+b'''}} переместить курсор на один символ влево

{{Key|'''ctrl+f'''}} переместить курсор на один символ вправо

{{Key|'''ctrl+t'''}} поменять местами символ слева от курсора и под курсором

{{Key|'''ctrl+h'''}} удалить символ слева от курсора

{{Key|'''ctrl+a'''}} переместить курсор в начало строки

{{Key|'''ctrl+e'''}} переместить курсор в конец строки

{{Key|'''ctrl+p'''}} предыдущая команда в истории bash

{{Key|'''ctrl+n'''}} следующая команда в истории bash

{{Key|'''ctrl+r'''}} реверсивный поиск команд в истории bash

{{Key|'''ctrl+y'''}} вставляет последнюю удаленную с помощью ctrl+u или ctrl+k строку

{{Key|'''ctrl+m'''}} выполнение команды, аналог [Enter]

{{Key|'''ctrl+o'''}} выполняет команду, при этом оставляя ее в командной строке для дальнейшего использования.

{{Key|'''ctrl+l'''}} очистить экран

{{Key|'''ctrl+s'''}} стоп режим. Блокирует вывод на консоль. При этом все данные отображенные на экране остаются не измененными.

{{Key|'''Tab+Tab'''}} выводит список команд. При наличии какого нибудь символа(-ов) выводит команды по введенным символам.

{{Key|'''ctrl+q'''}} выход из стоп-режима.

{{Key|'''ctrl+d'''}} выйти из терминала

{{Key|'''ctrl+c'''}} отменить последнюю введенную команду

{{Key|'''ctrl+x,ctrl+v'''}} показать версию bash

== Ссылки ==

[http://wiki.opennet.ru/Bash Bash]

[[Категория:Переводы с английского]]
[[Категория:Незавершённые статьи]]

Uvesafb

2012-03-15T23:12:10Z

Langator:

Uvesafb является новым framebuffer-драйвером для консоли, добавлен в ядро начиная с версии 2.6.24. Поддерживает больше функций, чем стандартный vesafb и является более предпочтительным в использовании (особенно касается систем с nvidia-видеокартами с проприетарным видеодрайвером). Требования к поддержке оборудования такие же, как и для vesafb.

= Демон виртуализации =

Особенностью этого драйвера является то, что для него требуется демон визуализации в userspace, называемый v86d. Возможно, кто-то подсчитает глупым решением то, что в x86-системе эмулируется x86-код, однако не стоит забывать о других платформах (в частности, не-x86 платформы), где может использоваться uvesafb. Пакет v86d включает в себя initcpio HOOK, называемый v86d, который по необходимости будет загружать модуль и запускать демон виртуализации.

Дальнейшие инструкции предназначены для ArchLinux.

== v86d ==

Установите v86d с помощью pacman

<source lang="bash">pacman -S v86d</source>

Следует обратить внимание на то, что v86d нуждается в перекомпилировании klibc.

= Настройка uvesafb =

#Удалите любые параметры ядра, относящиеся к настройке фреймбуфера: vga=xxx принудительно загружает старый vesafb; video=xxx не используется uvesafb в случае, если последний скомпилирован как модуль (как в стандартном ядре Arch Linux).
#Отключите KMS, иначе во время загрузке вы увидите черный экран. Если это произошло, перезагрузите машину с помощью комбинации ''Ctrl+Alt+Del''. Для карт Intel укажите в конфиг-файле Grub`a параметр <nowiki>i915.modeset=0</nowiki>

== Параметры uvesafb ==

Все параметры модуля Вы сможете найти в /etc/modprobe.d/uvesafb.conf (или в общем конфиге /etc/modprobe.d/modprobe.conf). Исходный файл пакета v86d содержит информацию о синтаксисе конфиг-файла и ссылку на дополнительную информацию:
<source lang="bash">
# В этом файле задаются параметры uvesafb.
# Используется следующий формат:
# options uvesafb mode=<xres>x<yres>[-<bpp>][@<refresh>] scroll=<ywrap|ypan|redraw>
#
#For more details see:
#http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/fb/uvesafb.txt

options uvesafb mode=1280x800-32 scroll=ywrap</source>

C 2.6.27 и выше строчка options должна выглядеть так:

<source lang="bash">options uvesafb mode_option=1280x800-32 scroll=ywrap</source>

Для получения списков поддерживаемых режимов экрана наберите

<source lang="bash"> cat /sys/bus/platform/drivers/uvesafb/uvesafb.0/vbe_modes</source>

== Настройка обработчиков (HOOKS) ==

Добавьте v86d в строку HOOKS содержащую обработчики используемые при создании initramfs образа. Строка имеет следующий формат:
{{file|/etc/mkinitcpio.conf|<source lang="bash">
HOOKS="base udev v86d ..."</source>}}

Если вы хотите перегенерировать initramfs образ, используйте команду:

<source lang="bash">mkinitcpio -p linux</source>
или
<source lang="bash">mkinitcpio -p kernel26</source>

=Возможные проблемы=
== Uvesafb cannot reserve memory ==
Скорее всего Вы забыли удалить "vga=xxx", из-за чего происходит конфликт между uvesafb и vesafb

== pci_root PNP0A08:00 address space collision + Uvesafb cannot reserve memory ==
Даже без другого фреймбуфера, uvesafb не может зарезервировать необходимую область памяти.
Вы можете исправить эту проблему, добавив следующие параметры ядра в конфигурацию вашего загрузчика.
<source lang="bash">pci=nocrs</source>

[[Категория:Руководства]]
[[Категория:Графика]]

MediaWiki:Edittools

2012-03-10T11:28:45Z

Langator:

<div id="editpage-specialchars" style="margin-top:1px;border:1px solid #aaa;padding:2px">
Быстрая вставка: <charinsert> «+» „+“ — … |</charinsert>
<charinsert>{{+}} [[+]] [+] [[|+]] {{+|}} <nowiki> </nowiki> <nowiki> </nowiki> <nowiki>&</nowiki>nbsp;</charinsert>
 <charinsert><nowiki>#REDIRECT [[</nowiki>+]]</charinsert> 

<div style="font-size:smaller;">
<charinsert><>+</> <nowiki></nowiki> + <s>+</s> + <big>+</big> + + <blockquote>+</blockquote> <math>+</math> <gallery>+</gallery> <tt>+</tt> <code>+</code> <nowiki><source lang=""><source lang="bash">+</source> </nowiki>+</source> <pre>+</pre> <nowiki>+</nowiki> <includeonly>+</includeonly> <noinclude>+</noinclude></charinsert>
<charinsert>__NOTOC__ __TOC__ __FORCETOC__</charinsert>

Разделы:
<charinsert><nowiki>== + ==</nowiki></charinsert>   <charinsert><nowiki>=== + ===</nowiki></charinsert>   <charinsert><nowiki>=== Итог ===</nowiki></charinsert>  <charinsert><nowiki>{{подст:Служебные разделы}}</nowiki></charinsert>   <charinsert><nowiki>== См. также ==</nowiki></charinsert>   <charinsert><nowiki>== Примечания ==
{{примечания}}</nowiki></charinsert>  <charinsert><nowiki>== Литература ==</nowiki></charinsert>  <charinsert><nowiki>== Ссылки ==</nowiki></charinsert>

Шаблоны:
<charinsert>{{tl|+}} {{lang-en|+}} {{ref-en}} {{unicode|+}} {{заготовка}} {{неоднозначность}} {{викифицировать}} {{чистить}} {{достоверность}} {{rq|+}}</charinsert>
<charinsert><nowiki>{{нет категорий}}</nowiki></charinsert>
<charinsert><nowiki>{{нет интервики}}</nowiki></charinsert>
<charinsert><nowiki>{{нет иллюстраций}}</nowiki></charinsert>
<charinsert><nowiki>{{Нарушение авторских прав|url=</nowiki>+}}</charinsert>
<charinsert><nowiki>{{подст:Предложение к удалению}}</nowiki></charinsert>
<charinsert><nowiki>{{закрыто}}+{{закрыто-конец}}</nowiki></charinsert>
<charinsert><nowiki>{{начало цитаты}}+{{конец цитаты|источник=}}</nowiki></charinsert>

</div>

Символы:
<charinsert>‘ “ ’ ” ~ # @ § ¶ № • · ← ↖ ↑ ↗ → ↘ ↓ ↙ ↔ ↕ ¡ ¿ \ ½ ¼ ¾ ≈ ≠ ± − × ÷ ° ^ ¹ ² ³ € £ ¥ $ ¢ † © ® ™</charinsert>
<charinsert> {{подст:ударение}}</charinsert>

Греческий алфавит:
<charinsert> Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η Θ θ Ι Ϊ ι ϊ Κ κ Λ λ Μ μ Ν ν Ξ ξ Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ Ϋ υ ϋ Φ φ Χ χ Ψ ψ Ω ω </charinsert>

<table id="edittools-table">
<tr>
<td width="120px" >Быстрая вставка:</td>
<td valign="top" class="editt" >

'''Ж''': <charinsert><nowiki>'''+'''</nowiki></charinsert>
''К'': <charinsert><nowiki>''+''</nowiki></charinsert> •
<charinsert> «+» „+“ — … | </charinsert> •
<charinsert><nowiki>{{</nowiki>+}}</charinsert>
<charinsert><nowiki>[[</nowiki>+]]</charinsert>
<nowiki>[[</nowiki>ссылка'''|'''<nowiki>]]</nowiki>: <charinsert>[[+|]]</charinsert> •
<nowiki>[[</nowiki>'''|'''лейбл<nowiki>]]</nowiki>: <charinsert>[[|+]]</charinsert> •
<nowiki>[</nowiki>внешняя ссылка<nowiki>]</nowiki>: <charinsert><nowiki>[</nowiki>+]</charinsert> • <charinsert><nowiki>#REDIRECT [[</nowiki>+]]</charinsert> •
<charinsert> </charinsert> •
<charinsert><nowiki> </nowiki> <nowiki> </nowiki></charinsert>
{{#switch:{{NAMESPACE}}|{{TALKSPACE}}|Lurkmore='''Подписи:''' Подпись IP или [[ник]]ом:<charinsert> <nowiki> </nowiki>—~~~</charinsert> С датой:<charinsert> <nowiki> </nowiki>—~~~~</charinsert> Только датой:<charinsert><nowiki> </nowiki>—~~~~~</charinsert> · <charinsert><nowiki>[[Участник:+]]</nowiki></charinsert> • <charinsert><nowiki>—''Анонимус''</nowiki></charinsert> • <charinsert><nowiki>—''Мимо проходил''</nowiki></charinsert>
|#default=}}</td>
</tr>
<tr>
<td>Разметка:</td>
<td valign="top" class="editt" >
'''<charinsert> <nowiki>== + ==</nowiki></charinsert>''' •
'''<charinsert> <nowiki>=== + ===</nowiki></charinsert>''' •
<charinsert><nowiki>== Примечания ==</nowiki></charinsert> •
<charinsert><nowiki><references /></nowiki></charinsert> •
<charinsert><nowiki>== См. также ==</nowiki></charinsert> •
<charinsert><nowiki>== Ссылки ==</nowiki></charinsert> •
<charinsert>[[Категория:+]]</charinsert>
 
'''Ж''': <charinsert><nowiki>'''+'''</nowiki></charinsert>
''К'': <charinsert><nowiki>''+''</nowiki></charinsert>
П: <charinsert><nowiki>+</nowiki></charinsert> •
надстр: <charinsert><nowiki>+</nowiki></charinsert>
подстр: <charinsert><nowiki>+</nowiki></charinsert> •
<charinsert><nowiki><nowiki>+</nowiki></nowiki></charinsert>
<charinsert> <>+</> + <div>+</div> <nowiki></charinsert> <charinsert><nowiki><pre>+</pre></nowiki></charinsert>
<charinsert><nowiki> </nowiki> <nowiki> </nowiki></charinsert> •
<charinsert> <nowiki>__TOC__</nowiki></charinsert> •
<charinsert> <nowiki>__NOTOC__</nowiki></charinsert> •
<charinsert> <nowiki>{{</nowiki>TOCright}}</charinsert> •
<charinsert> <nowiki>{{</nowiki>DEFAULTSORT:}}</charinsert> •
<charinsert> <nowiki>{{</nowiki>PAGENAME}}</charinsert> •
<charinsert><nowiki><noinclude>+</noinclude></nowiki></charinsert>
</td></tr>{{#switch:{{NAMESPACE}}|Шаблон|Участник=
<tr>
<td>Разметка шаблона:</td>
<td valign="top" class="editt" >
<charinsert><nowiki><noinclude>+</noinclude></nowiki></charinsert>
<charinsert><nowiki><includeonly>+</includeonly></nowiki></charinsert>
<charinsert><nowiki>{{doc}}</nowiki></charinsert> •
<charinsert><nowiki>{{docpage}}</nowiki></charinsert> •
<charinsert><nowiki>{{#if:+||}}</nowiki></charinsert>
<charinsert><nowiki>{{#ifeq:+||}}</nowiki></charinsert>
<charinsert><nowiki>{{#switch:+|=|#default=}}</nowiki></charinsert> •
<charinsert><nowiki>{{lc:+}}</nowiki></charinsert>
<charinsert><nowiki>{{lcfirst:+}}</nowiki></charinsert>
<charinsert><nowiki>{{uc:+}}</nowiki></charinsert>
<charinsert><nowiki>{{ucfirst:+}}</nowiki></charinsert>
<charinsert><nowiki>{{PAGENAME}}</nowiki></charinsert>
<charinsert><nowiki>{{SUBPAGENAME}}</nowiki></charinsert> •
<charinsert><nowiki>{{NAMESPACE}}</nowiki></charinsert>
<charinsert><nowiki>{{TALKSPACE}}</nowiki></charinsert>
<charinsert><nowiki>{{{1}}}</nowiki></charinsert>
<charinsert><nowiki>{{{2}}}</nowiki></charinsert>
<charinsert><nowiki>{{{3}}}</nowiki></charinsert> •
<charinsert><nowiki>{{{1|+}}}</nowiki></charinsert>
<charinsert><nowiki>{{{2|+}}}</nowiki></charinsert>
<charinsert><nowiki>{{{3|+}}}</nowiki></charinsert>
</td></tr>
|}}
<tr>
<td>Цитирование:</td>
<td valign="top" class="editt" >

<charinsert><nowiki><code>+</code></nowiki></charinsert> •
<charinsert><nowiki><source lang="bash">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="C">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="cpp">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="css">+</source></nowiki></charinsert>
</td></tr>

</table>
<div align="right">[[MediaWiki:Edittools|Редактировать]]</div>
</div>

MediaWiki:Edittools

2012-03-10T11:26:55Z

Langator:

<div id="editpage-specialchars" style="margin-top:1px;border:1px solid #aaa;padding:2px">
Быстрая вставка: <charinsert> «+» „+“ — … |</charinsert>
<charinsert>{{+}} [[+]] [+] [[|+]] {{+|}} <nowiki> </nowiki> <nowiki> </nowiki> <nowiki>&</nowiki>nbsp;</charinsert>
 <charinsert><nowiki>#REDIRECT [[</nowiki>+]]</charinsert> 

<div style="font-size:smaller;">
<charinsert><>+</> <nowiki></nowiki> + <s>+</s> + <big>+</big> + + <blockquote>+</blockquote> <math>+</math> <gallery>+</gallery> <tt>+</tt> <code>+</code> <nowiki><source lang=""><source lang="bash">+</source> </nowiki>+</source> <pre>+</pre> <nowiki>+</nowiki> <includeonly>+</includeonly> <noinclude>+</noinclude></charinsert>
<charinsert>__NOTOC__ __TOC__ __FORCETOC__</charinsert>

Разделы:
<charinsert><nowiki>== + ==</nowiki></charinsert>   <charinsert><nowiki>=== + ===</nowiki></charinsert>   <charinsert><nowiki>=== Итог ===</nowiki></charinsert>  <charinsert><nowiki>{{подст:Служебные разделы}}</nowiki></charinsert>   <charinsert><nowiki>== См. также ==</nowiki></charinsert>   <charinsert><nowiki>== Примечания ==
{{примечания}}</nowiki></charinsert>  <charinsert><nowiki>== Литература ==</nowiki></charinsert>  <charinsert><nowiki>== Ссылки ==</nowiki></charinsert>

Шаблоны:
<charinsert>{{tl|+}} {{lang-en|+}} {{ref-en}} {{unicode|+}} {{заготовка}} {{неоднозначность}} {{викифицировать}} {{чистить}} {{достоверность}} {{rq|+}}</charinsert>
<charinsert><nowiki>{{нет категорий}}</nowiki></charinsert>
<charinsert><nowiki>{{нет интервики}}</nowiki></charinsert>
<charinsert><nowiki>{{нет иллюстраций}}</nowiki></charinsert>
<charinsert><nowiki>{{Нарушение авторских прав|url=</nowiki>+}}</charinsert>
<charinsert><nowiki>{{подст:Предложение к удалению}}</nowiki></charinsert>
<charinsert><nowiki>{{закрыто}}+{{закрыто-конец}}</nowiki></charinsert>
<charinsert><nowiki>{{начало цитаты}}+{{конец цитаты|источник=}}</nowiki></charinsert>

</div>

Символы:
<charinsert>‘ “ ’ ” ~ # @ § ¶ № • · ← ↖ ↑ ↗ → ↘ ↓ ↙ ↔ ↕ ¡ ¿ \ ½ ¼ ¾ ≈ ≠ ± − × ÷ ° ^ ¹ ² ³ € £ ¥ $ ¢ † © ® ™</charinsert>
<charinsert> {{подст:ударение}}</charinsert>

Греческий алфавит:
<charinsert> Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η Θ θ Ι Ϊ ι ϊ Κ κ Λ λ Μ μ Ν ν Ξ ξ Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ Ϋ υ ϋ Φ φ Χ χ Ψ ψ Ω ω </charinsert>

<table id="edittools-table">
<tr>
<td width="120px" >Быстрая вставка:</td>
<td valign="top" class="editt" >

'''Ж''': <charinsert><nowiki>'''+'''</nowiki></charinsert>
''К'': <charinsert><nowiki>''+''</nowiki></charinsert> •
<charinsert> «+» „+“ — … | </charinsert> •
<charinsert><nowiki>{{</nowiki>+}}</charinsert>
<charinsert><nowiki>[[</nowiki>+]]</charinsert>
<nowiki>[[</nowiki>ссылка'''|'''<nowiki>]]</nowiki>: <charinsert>[[+|]]</charinsert> •
<nowiki>[[</nowiki>'''|'''лейбл<nowiki>]]</nowiki>: <charinsert>[[|+]]</charinsert> •
<nowiki>[</nowiki>внешняя ссылка<nowiki>]</nowiki>: <charinsert><nowiki>[</nowiki>+]</charinsert> • <charinsert><nowiki>#REDIRECT [[</nowiki>+]]</charinsert> •
<charinsert> </charinsert> •
<charinsert><nowiki> </nowiki> <nowiki> </nowiki></charinsert>
{{#switch:{{NAMESPACE}}|{{TALKSPACE}}|Lurkmore='''Подписи:''' Подпись IP или [[ник]]ом:<charinsert> <nowiki> </nowiki>—~~~</charinsert> С датой:<charinsert> <nowiki> </nowiki>—~~~~</charinsert> Только датой:<charinsert><nowiki> </nowiki>—~~~~~</charinsert> · <charinsert><nowiki>[[Участник:+]]</nowiki></charinsert> • <charinsert><nowiki>—''Анонимус''</nowiki></charinsert> • <charinsert><nowiki>—''Мимо проходил''</nowiki></charinsert>
|#default=}}</td>
</tr>
<tr>
<td>Разметка:</td>
<td valign="top" class="editt" >
'''<charinsert> <nowiki>== + ==</nowiki></charinsert>''' •
'''<charinsert> <nowiki>=== + ===</nowiki></charinsert>''' •
<charinsert><nowiki>== Примечания ==</nowiki></charinsert> •
<charinsert><nowiki><references /></nowiki></charinsert> •
<charinsert><nowiki>== См. также ==</nowiki></charinsert> •
<charinsert><nowiki>== Ссылки ==</nowiki></charinsert> •
<charinsert>[[Категория:+]]</charinsert>
 
'''Ж''': <charinsert><nowiki>'''+'''</nowiki></charinsert>
''К'': <charinsert><nowiki>''+''</nowiki></charinsert>
П: <charinsert><nowiki>+</nowiki></charinsert> •
надстр: <charinsert><nowiki>+</nowiki></charinsert>
подстр: <charinsert><nowiki>+</nowiki></charinsert> •
<charinsert><nowiki><nowiki>+</nowiki></nowiki></charinsert>
<charinsert> <>+</> + <div>+</div> <nowiki></charinsert> <charinsert><nowiki><pre>+</pre></nowiki></charinsert>
<charinsert><nowiki> </nowiki> <nowiki> </nowiki></charinsert> •
<charinsert> <nowiki>__TOC__</nowiki></charinsert> •
<charinsert> <nowiki>__NOTOC__</nowiki></charinsert> •
<charinsert> <nowiki>{{</nowiki>TOCright}}</charinsert> •
<charinsert> <nowiki>{{</nowiki>DEFAULTSORT:}}</charinsert> •
<charinsert> <nowiki>{{</nowiki>PAGENAME}}</charinsert> •
<charinsert><nowiki><noinclude>+</noinclude></nowiki></charinsert>
</td></tr>{{#switch:{{NAMESPACE}}|Шаблон|Участник=
<tr>
<td>Разметка шаблона:</td>
<td valign="top" class="editt" >
<charinsert><nowiki><noinclude>+</noinclude></nowiki></charinsert>
<charinsert><nowiki><includeonly>+</includeonly></nowiki></charinsert>
<charinsert><nowiki>{{doc}}</nowiki></charinsert> •
<charinsert><nowiki>{{docpage}}</nowiki></charinsert> •
<charinsert><nowiki>{{#if:+||}}</nowiki></charinsert>
<charinsert><nowiki>{{#ifeq:+||}}</nowiki></charinsert>
<charinsert><nowiki>{{#switch:+|=|#default=}}</nowiki></charinsert> •
<charinsert><nowiki>{{lc:+}}</nowiki></charinsert>
<charinsert><nowiki>{{lcfirst:+}}</nowiki></charinsert>
<charinsert><nowiki>{{uc:+}}</nowiki></charinsert>
<charinsert><nowiki>{{ucfirst:+}}</nowiki></charinsert>
<charinsert><nowiki>{{PAGENAME}}</nowiki></charinsert>
<charinsert><nowiki>{{SUBPAGENAME}}</nowiki></charinsert> •
<charinsert><nowiki>{{NAMESPACE}}</nowiki></charinsert>
<charinsert><nowiki>{{TALKSPACE}}</nowiki></charinsert>
<charinsert><nowiki>{{{1}}}</nowiki></charinsert>
<charinsert><nowiki>{{{2}}}</nowiki></charinsert>
<charinsert><nowiki>{{{3}}}</nowiki></charinsert> •
<charinsert><nowiki>{{{1|+}}}</nowiki></charinsert>
<charinsert><nowiki>{{{2|+}}}</nowiki></charinsert>
<charinsert><nowiki>{{{3|+}}}</nowiki></charinsert>
</td></tr>
|}}
<tr>
<td>Цитирование:</td>
<td valign="top" class="editt" >

<charinsert><nowiki><code>+</code></nowiki></charinsert> •
<charinsert><nowiki><source lang="bash">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="C">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="cpp">+</source></nowiki></charinsert> •
<charinsert><nowiki><source lang="css">+</source></nowiki></charinsert>
</td></tr>

</table>
<div align="right">[[MediaWiki:Edittools|Редактировать]]</div>
</div>

MediaWiki:Edittools

2012-03-10T10:05:35Z

Langator:

Заглавная страница

2012-02-08T20:02:02Z

Langator: Защищена страница «Заглавная страница» ([edit=sysop] (бессрочно) [move=sysop] (бессрочно))

__NOTOC__
<div ALIGN=JUSTIFY>



<div style="width:57%; padding-right: 3%; float: left;">


== О проекте Ай Да Linux ==
<div style="float: right;">[[File:Larry-hi.png|moo|link=]]</div>
{{Главная страница}}


== Getting started ==
Вы можете редактировать и создавать страницы на этой Wiki.

Для навигации по сайту можно воспользоваться поиском, посмотреть [[Служебная:AllPages|все]] имеющиеся статьи или [[%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:Random|случайную]].
Прежде чем редактировать или создавать новые страницы, пожалуйста, обратитесь к [[Справка:Содержание|справке]]. Так же можно заглянуть в [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki User's Guide] содержащий информацию о работе wiki.

Если у Вас возникнут какие-либо вопросы, Вы всегда можете написать нам по адресу [mailto:aidalinux@gmail.com aidalinux@gmail.com].

</div>



<div style="width: 40%; float: left;">


== News ==
{{News|17.12.2011|Добро пожаловать на Ай Да Linux Wiki|
Идет активное формирование главной страницы Wiki, пожелания и предложения оставляйте на [[%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5:%D0%97%D0%B0%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0 | странице обсуждения]].
}}



== Недавно добавленные страницы ==
{{Special:NewPages/5}}
</div>



</div>

Русские клавиши в VIM

2011-12-24T17:57:16Z

Langator: Новая страница: «Часто возникает вопрос - как не переключая раскладки на английский давать команды vim. {{file ...»

Часто возникает вопрос - как не переключая раскладки на английский давать команды vim.

{{file | $vim ~/.vimrc |
<source lang="bash">
set langmap=йq,цw,уe,кr,еt,нy,гu,шi,щo,зp,х[,ъ],фa,ыs,вd,аf,пg,рh,оj,лk,дl,э',яz,чx,сc,мv,иb,тn,ьm,б\,,ю.,ё`,ЙQ,ЦW,УE,КR,ЕT,НY,ГU,ШI,ЩO,ЗP,Х{,Ъ},ФA,ЫS,ВD,АF,ПG,РH,ОJ,ЛK,ДL,Э\",ЯZ,ЧX,СC,МV,ИB,ТN,ЬM,Б\<,Ю\>,Ё\~
</source> }}
Подробнее:
:help langmap

==Найдено==
Рассылка debian-russian@lists.debian.org

== Недостатки ==
К сожалению, это работает только с 8-битовыми кодировками, но не с юникодом. Чтобы работало с юникодом необходимо использовать [http://lostclus.linux.kiev.ua/Другие_работы/Патчи патч для Vim] Константина Корикова.

Заглавная страница

2011-12-24T17:49:59Z

Langator: /* Недавно добавленные страницы */

Шаблон:IPstack

2011-12-24T17:48:10Z

Langator:

<div style="float:right;margin:15px;margin-top:0px;padding:0px;border: 2px solid #aaa;background:#efefef;">
<table border="0" cellspacing="2" cellpadding="2">
<caption>'''[[Сетевые протоколы индекс|Сетевые протоколы]] '''</caption>
<tr align=left bgcolor="#CCCCFF">
<td bgcolor="#FFEECC">[[Сетевые протоколы индекс#Протоколы уровня приложения|Прикладной уровень]]</td>
<td>[[HTTP]], [[SMTP]], [[SSH]], [[SNMP]], [[FTP]], [[NNTP]], [[NTP]], [[LDAP]], ...</td>
</tr>
<tr align=left bgcolor="#CCCCFF">
<td bgcolor="#FFEECC">[[Сетевые протоколы индекс#Протоколы сеансового уровня|Сеансовый уровень]]</td>
<td>[[TLS]], [[SSL]], [[RPC]], [[WSP]]...</td>
</tr>
<tr align=left bgcolor="#CCCCFF">
<td bgcolor="#FFEECC">[[Сетевые протоколы индекс#Протоколы транспортного уровня|Транспортный уровень]]</td>
<td>[[TCP]], [[UDP]], [[SCTP]], [[ICMP]], [[OSPF]], [[RSVP]], [[VRRP]], [[RTP]], [[DCCP]] ...</td>
</tr>
<tr align=left bgcolor="#CCCCFF">
<td bgcolor="#FFEECC">[[Сетевые протоколы индекс#Протоколы сетевого уровня|Сетевой уровень]]</td>
<td>[[IP|IPv4]], [[IPv6]], [[ARP]], [[RARP]], [[MPLS]], [[IPX]] ...</td>
</tr>
<tr align=left bgcolor="#EEEEFF">
<td bgcolor="#FFFFEE">[[Сетевые протоколы индекс#Протоколы канального уровня|Канальный уровень]]</td>
<td>[[Ethernet]], [[IEEE 802|802.11]], [[DSL|xDSL]], [[Fibre Channel]], [[FDDI]], [[ATM]], [[ISDN]] ...</td>
</tr>
</table>
</div>

Подробная настройка iptables

2011-12-24T17:47:01Z

Langator: Новая страница: «Category:Руководства ==Введение== Документация по iptables в сети не рассчитана на новичков. В эт...»

[[Category:Руководства]]
==Введение==
Документация по iptables в сети не рассчитана на новичков. В этой статье будет сжато и быстро описаны команды, затем, возможно, будут правки и добавления для расширенного обьяснения. Так что это будет минимальная установка которую мы в дальнейшем расширим и упрочним с помощью правил.
:Так же примите во внимание, что будет использовано pppoe соединение и 2.6.x ядро. Для настройки сетевой карты надо будет заменить '''ppp0''' на '''eth0''' (или подходящий по смыслу ваш сетевой интерфейс глядящий в интернет)

===Прежде чем двигаться дальше - убедитесь, что ...===
:* 1.Всё ваше аппаратное обеспечение работоспособно. То есть вы все подключили, модули грузятся, устройства видны в системе. Полезно вначале проверить, что соединение с интернетом возможно и без всяких там iptables. Нет ничего хуже, чем в течение многих часов возиться с упрямой программой, ругая её почём зря, а потом понять, что сетевая плата не работает или модем сконфигурирован неправильно.
:* 2.Вы читали маны по теме. Предполагается, что, пока вы изучаете это руководство, man iptables постоянно открыт в соседнем терминале для точного понимания и уточнения, что же та или иная команда означает на самом деле.
:* 3.Вы имеете представление о сетевых технологиях и Вы знакомы с администрированием Linux и Gentoo Linux в частности. То есть необходимы навыки работы с такими базовыми вещами как [[ifconfig]], [[rc-update]], {{Path|/etc/conf.d/net}}, и так далее. Если для вас это пока пустые звуки, то, пожалуйста предварительно изучите [http://www.gentoo.org/doc/en/handbook/index.xml The Gentoo Handbook] и [http://www.linuxhelp.ca/guides/networkbasics/ Linux Help's Networking Basics 101]

===Конфигурация ядра===
Все что вам нужно - это включить поддержку iptables.
{{Kernel|Включение IPTables|
Device Drivers--->
Networking Support--->
Networking Options---->
Network Packet Filtering (replace Ipchains)--->
Netfilter Configuration}}

{{Kernel|Включение IPTables (kernel 2.6.35)|
-> Networking support
-> Networking options
-> Network packet filtering framework (Netfilter)
-> Core Netfilter Configuration}}

: Я включил все опции как модули (с тем рассчетом, что я захочу попробовать другие опции позже) и добавил ip_tables в modules.autoload. Это загрузит еще несколько модулей в качестве зависимостей. Модуль ip_conntrack необходим для "statefull" фильтрования, то есть для отслеживания соединений. Для запуска скриптов выполните команду :

{{Codeline|# modprobe ip_tables}}

===Необходимые утилиты===
Далее вы должны установить пакет iptables:

{{Codeline|# emerge iptables}}

===Конфигурация интерфейсов===
{{IPstack}}
В моем случае имеется 3 сетевых адаптера. Один подключен к [[WAN]] через pppoe. Другие два - к моей внутренней сети. Для того, чтобы не было проблем с iptables и маскардингом ([[NAT]]'ом), они должны быть сконфигурированы для различных подсетей. Для примера, 2 сетевых адаптера подключены к моим внутренним компьютерам (внутренние сетевые интерфейсы). Им присвоены IP-адреса: 192.168.1.1 и 192.168.2.1.

Следует заметить, что будет лучше если подключать эти внутренние адаптеры в любое сетевое устройство, такие как свитч и хаб. Для pppoe подключений мы должны убедиться, что сетевой адаптер подключен к внешнему миру, то есть внешним интерфейсам не присвоены никакие IP-адреса. Его запись в {{Path|/etc/conf.d/net}} должна оставаться пустой. Это делается потому, что pppoe выступает в качестве виртуального устройства, которое включается вслед за сетевым интерфейсом. Мы также должны присвоить правильные сетевые маски и широковещательные адреса для этих интерфейсов. Ваш {{Path|conf.d/}} должна выглядеть примерно так:

====Сервер====
{{File|/etc/conf.d/net|<source lang="bash">
# Для pppoe подключений вы не должны указывать значения для ppp0,
# просто добавьте net.ppp0 или rc-pppoe в default уровень загрузки.
iface_eth1="192.168.1.1 broadcast 192.168.1.255 netmask 255.255.255.0"
iface_eth2="192.168.2.1 broadcast 192.168.2.255 netmask 255.255.255.0"
</source>
}}
:Заметьте, что не было указано никаких шлюзов.

====Клиент1====
{{File|/etc/conf.d/net|
<source lang="bash">
iface_eth0="192.168.1.77 broadcast 192.168.1.255 netmask 255.255.255.0"
gateway="eth0/192.168.1.1"
</source>
}}
====Клиент2====
{{File|/etc/conf.d/net|
<source lang="bash">
iface_eth0="192.168.2.77 broadcast 192.168.2.255 netmask 255.255.255.0"
gateway="eth0/192.168.2.1"
</source>
}}
Шлюз для клиентов установлен на внутренний IP сетевого интерфейса сервера, что и логично. Теперь добавьте все интерфейсы в default уровень загрузки и перезапустите подключения:

{{Codeline| # rc-update add net.eth1 default && rc-update add net.eth2 default && rc-update add net.ppp0 default}}

и

{{Codeline|# /etc/init.d/net.eth1 start && /etc/init.d/net.eth2 start && /etc/init.d/net.ppp0 start}}
* Для клиентов:
{{Codeline|# /etc/init.d/net.eth0 restart}}

===Проверка настроек===
Теперь убедитесь в том, что ваш сервер подключен к интернету, а также все интерфейсы могут пинговать друг друга.
Для сервера:
{{Code|ping|
ping www.google.com;
ping 192.168.1.77
ping 192.168.2.77
}}
:Убедитесь что у клиентов правильно указаны [[DNS]]-сервера в {{Path|/etc/resolv.conf}}

===Scripting===
:Теперь интересная часть... iptables и NAT(трансляция адресов). Для начала сделаем простое перенаправление адресов с минимальными правилами, чтобы убедиться что можем выходить в сеть.

{{Warning|Если вы параноик, то это не самое секретное, что можно сделать... мы открываемся в сеть с мизерной защитой. Однако будем считать, что сеть настраиваем для дома или для игрового класса.}}

{{File|/var/lib/iptables/rules-save|
<source lang="bash">#!/bin/bash
IPTABLES='/sbin/iptables'

# Определяем интерфейсы
EXTIF='ppp0'
INTIF1='eth1'
INTIF2='eth2'

# Включаем форвардинг ip в ядре.
/bin/echo 1 > /proc/sys/net/ipv4/ip_forward

# Сбросить правила и удалить цепочки
$IPTABLES -F
$IPTABLES -t nat -F
$IPTABLES -t mangle -F
$IPTABLES -X
$IPTABLES -t nat -X
$IPTABLES -t mangle -X

# Включаем маскарадинг для разрешения доступа в интернет
$IPTABLES -t nat -A POSTROUTING -o $EXTIF -j MASQUERADE

# Форвардить сетевой трафик с $INTIF1 на интернетовский интерфейс $EXTIF
$IPTABLES -A FORWARD -i $INTIF1 -o $EXTIF -m state --state NEW,ESTABLISHED -j ACCEPT

# Форвардить сетевой трафик с $INTIF2 на интернетовский интерфейс $EXTIF
$IPTABLES -A FORWARD -i $INTIF2 -o $EXTIF -m state --state NEW,ESTABLISHED -j ACCEPT

#echo -e " - Разрешаем доступ к SSH серверу"
$IPTABLES -A INPUT --protocol tcp --dport 22 -j ACCEPT
#echo -e " - Разрешаем доступ к HTTP серверу"
$IPTABLES -A INPUT --protocol tcp --dport 80 -j ACCEPT
# Блокируем все прочие попытки доступа на $EXTIF
$IPTABLES -A INPUT -i $EXTIF -m state --state NEW,INVALID -j DROP
$IPTABLES -A FORWARD -i $EXTIF -m state --state NEW,INVALID -j DROP</source> }}

==Проверка на работоспособность==
{{Note| Этот скрипт написан кем-то в сетевом форуме... Адрес автора утерян, имя... В общем, спасибо ему, пусть и без имени. (Надеюсь, он не обидится).}}
:Теперь проверяем могут ли наши пользователи выйти в интернет или подключиться к серверу по ssh. Если все нормально, то можно переходить ниже по тексту. Если нет - проверьте синтаксические ошибки и прочее... Удостоверьтесь, что IP-адреса и маски клиентов и сервера введены правильно... Ну или...
:Если все работает, как задумали, сохраняем конфигурацию:

{{Codeline|# /etc/init.d/iptables save}}

:И бэкапим вашу рабочую конфигурацию для возможного восстановления "как было":

{{Codeline|# cp /var/lib/iptables/rules-save /var/lib/iptables/rules.working}}

:Проверим iptables start-up скрипт перед тем как добавить iptables в default runlevel:

{{Code|Проверка скрипта|
# /etc/init.d/iptables start
# /etc/init.d/iptables stop
# /etc/init.d/iptables start}}

:Смысл в запуске-остановке-запуске в том, что у нас нет скрипта запуска iptables... поэтому нужно “инициализировать” статус перед остановкой. Остановка, по существу, обнуляет настройки и возвращает все к исходному. Перезапуск покажет нам работает ли наша сеть после перезагрузки. Если все в порядке, то добавляем iptables в default runlevel:

{{Codeline|rc-update add iptables default}}

:Не забудем также установить в /etc/sysctl.conf:

{{Codeline|<nowiki>net.ipv4.ip_forward = 1</nowiki>}}
:Часть II рассматривает правила установок и политики для обороны Вашего маршрутизатора.

==ЧАСТЬ III - Оборона Firewall==
:Далее мы сделаем наш, уже работающий файрвол безопасным, т.е. защищающим нашу систему от проникновений извне. На самом деле нам придется настроить файрвол таким образом, чтобы он не только защищал нас, но и защищал внешнюю сеть от нас. :) Защита такого рода является обязательной, она нужна для того, чтобы, в том случае, если наша система все-таки была взломана, взломщик не смог воспользоваться нашими ресурсами для дальнейшей атаки любого рода. Этот аспект является важнейшим в сетях класса SOHO, т.е. небольших офисах. Обыкновенно вирусы не оказывают никакого влияния на малые сети и заражение ими редко приводит к потере данных. Для нас, пользователей *nix, этой проблемы практически не существует. В любом случае, т.к. небольшие сети, как правило, защищены гораздо хуже больших, кракеры стараются использовать их в качестве “опорной базы” для DoS атак, или другой своей вредоносной активности.
:В последующем я опишу всю конфигурацию по кусочкам, дабы мы смогли бы проверить пошагово каждый фрагмент. Каждый шаг может потребовать от вас вставки чего-либо до, после или в середину указываемого скрипта. Все действия производятся так, чтобы (я надеюсь) ваша сеть не работала только лишь короткий промежуток времени во время настройки. Это сделано мною потому как я предположил что у многих из вас (таких как я) выделен сервер под Firewall. И так как я предпочитаю настраивать свой сервер через SSH, отключение сети может иметь пренеприятные посделствия, такие как ползания под столами или хуже того. Если же вы смелы, то вы можете скопировать скрипт в конце этого документа и запустить его на своей машине. Этот скрипт должен быть работоспособен на все сто, но тестировал я его только на своей машине, так что [http://lingvo.yandex.ru/en?text=YMMV ymmv].

===Установка переменных окружения===
:Вы можете установить необходимые переменные окружения следующим скриптом:

{{Code||
<source lang="bash">#!/bin/sh
#
# Внешний интерфейс
EXTIF="ppp0"

# Внутренний интерфейс
INTIF="eth1"

# Loop device/localhost
LPDIF="lo"
LPDIP="127.0.0.1"
LPDMSK="255.0.0.0"
LPDNET="$LPDIP/$LPDMSK"

# Необходимые утилиты
IPT="/sbin/iptables"
IFC="/sbin/ifconfig"
G="/bin/grep"
SED="/bin/sed"
AWK="/usr/bin/awk"
ECHO="/bin/echo"

# Последующие команды могут работать некорректно при локализации.

# Установка переменных окружения внешнего интерфейса
EXTIP="`$IFC $EXTIF | $AWK /$EXTIF/'{next}//{split($0,a,":");split(a[2],a," ");print a[1];exit}'`"
EXTBC="255.255.255.255"
#EXTMSK="`$IFC $EXTIF | $G Mask:|$SED 's/.*Mask:$[^ ]*$/\1/'`"
EXTMSK="`$IFC $EXTIF | $AWK /$EXTIF/'{next}//{split($0,a,":");split(a[4],a," ");print a[1];exit}'`"
EXTNET="$EXTIP/$EXTMSK"
$ECHO "EXTIP=$EXTIP EXTBC=$EXTBC EXTMSK=$EXTMSK EXTNET=$EXTNET"

# Due to absence of EXTBC I manually set it to 255.255.255.255
# this (hopefully) will serve the same purpose

# Установка переменных окружения внутреннего интерфейса
INTIP="`$IFC $INTIF | $AWK /$INTIF/'{next}//{split($0,a,":");split(a[2],a," ");print a[1];exit}'`"
INTBC="`$IFC $INTIF | $AWK /$INTIF/'{next}//{split($0,a,":");split(a[3],a," ");print a[1];exit}'`"
INTMSK="`$IFC $INTIF | $AWK /$INTIF/'{next}//{split($0,a,":");split(a[4],a," ");print a[1];exit}'`"
INTNET="$INTIP/$INTMSK"
$ECHO "INTIP=$INTIP INTBC=$INTBC INTMSK=$INTMSK INTNET=$INTNET"</source> }}

===iptables ACCEPTS===
:Теперь мы должны установить ACCEPTы, так, чтобы мы могли соединяться с нашим сервером. На самом деле это очень больной вопрос. Правила для надежного маршрутизатора должны по умолчанию запрещать нежели разрешать. Однако, если вы сделаете это, то потеряете все соединения. Продолжайте тестирование пока не будете уверены что ваши ACCEPTы работают как надо. Однако думаю, что сперва мы введем следующее и это будет предпоследним правилом в окончательном скрипте.
{{Code||
<source lang="bash">$IPT -t nat -A PREROUTING -j ACCEPT
# $IPT -t nat -A POSTROUTING -o $EXTIF -s $INTNET -j SNAT --to $EXTIP

# Закомментируйте последующие строки (которые содержат "MASQUERADE")
# для сетей без трансляции адресов (NAT)
$IPT -t nat -A POSTROUTING -o $EXTIF -s $INTNET1 -j MASQUERADE
$IPT -t nat -A POSTROUTING -o $EXTIF -s $INTNET2 -j MASQUERADE
$IPT -t nat -A POSTROUTING -j ACCEPT
$IPT -t nat -A OUTPUT -j ACCEPT
$IPT -A INPUT -p tcp --dport auth --syn -m state --state NEW -j ACCEPT
$IPT -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
$IPT -A OUTPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
$IPT -A FORWARD -m state --state ESTABLISHED,RELATED -j ACCEPT</source> }}

===iptables DROP & REJECT===
:Теперь мы определим пару цепочек (chains) которые будут фиксировать события DROP и REJECT. Таким образом нам не придется вводить отдельные строки для каждой введенной команды. Сообщения о событиях будут отправлены сервису syslog, (обычно они фиксируются в /var/log/messages). Позже я (переводчик не имеет к этому никакого отношения) собираюсь написать скрипт на sed/grep по разбору событий для облегченного просмотра и установлю его как ежедневную работу для сервиса cron.
:Эти строки следует вставить сразу после текста выше, в тот же скрипт. Когда вы это сделаете, запустите скрипт снова. Это не окажет влияния на вашу сеть, вы пока просто устанавливаете правила. Но это поможет убедиться что мы не сделали ошибок на данном этапе.
{{Code||
<source lang="bash"># ********** Цепочки журналирования событий **********
#
# Теперь мы определяем несколько цепочек которые служат для записи
# событий о сбрасываемых пакетах. Это позволит нам избежать ввода
# команд для каждого правила. Сперва мы фиксируем DROP, а потом REJECT.
# Не жалуйтесь, если цепочки уже существуют (однако это не приведет к ошибкам???)
$IPT -N DROPl 2> /dev/null
$IPT -A DROPl -m limit --limit 3/minute --limit-burst 10 -j LOG --log-prefix 'FIREWALL DROP BLOCKED:'
$IPT -A DROPl -j DROP
$IPT -N REJECTl 2> /dev/null
$IPT -A REJECTl -m limit --limit 3/minute --limit-burst 10 -j LOG --log-prefix 'FIREWALL REJECT BLOCKED:'
$IPT -A REJECTl -j REJECT
$IPT -N DROP2 2> /dev/null
$IPT -A DROP2 -m limit --limit 3/second --limit-burst 10 -j LOG --log-prefix 'FIREWALL DROP UNKNOWN:'
$IPT -A DROP2 -j DROP
$IPT -N REJECT2 2> /dev/null
$IPT -A REJECT2 -m limit --limit 3/second --limit-burst 10 -j LOG --log-prefix 'FIREWALL REJECT UNKNOWN:'
$IPT -A REJECT2 -j REJECT

# Для тестирования фиксируем события ACCEPT
$IPT -N ACCEPTl 2> /dev/null
$IPT -A ACCEPTl -m limit --limit 10/second --limit-burst 50 -j LOG --log-prefix 'FIREWALL ACCEPT:'
$IPT -A ACCEPTl -j ACCEPT</source> }}


===Сброс правил===
:Теперь, когда мы видим наши устройства, правильно определенные, вставляем команду сброса правил. Однако все уже назначенные правила будут сброшены. Эти строки должны быть вставлены после определения утилит, которые заканчиваются строкой: ECHO='/bin/echo'
{{Code||
<source lang="bash"># Сброс всех существующих и очистка персональных цепочек.
CHAINS=`cat /proc/net/ip_tables_names 2>/dev/null`

for i in $CHAINS
do
$IPT -t $i -F
done

for i in $CHAINS
do
$IPT -t $i -X
done</source>
}}

===Локальные интерфейсы===
:Теперь мы готовы для того, чтобы описать некоторые правила. Для начала мы разрешим все пакеты с loopback интерфейса, имеющие в качестве адреса назначения один из адресов наших интерфейсов.
{{Code||
<source lang="bash">
$IPT -A INPUT -i $LPDIF -s $LPDIP -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $EXTIP -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $INTIP1 -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $INTIP2 -j ACCEPT
</source> }}

===Блокировка широковещательных пакетов===
:Теперь мы должны заблокировать все входящие и исходящие широковещательные пакеты. Это предотвратит DoS атаки против нас, и не позволит нашим клиентам проводить DoS атаки против кого либо другого. Если бы все системные администраторы следовали этим правилам, тогда много суровых и дорогих DoS атак не состоялись или были максимально ограниченными.

{{Code|Блокировка широковещательных пакетов|
<source lang="bash">
$IPT -A INPUT -i $EXTIF -d $EXTBC -j DROPl
$IPT -A INPUT -i $INTIF1 -d $INTBC1 -j DROPl
$IPT -A INPUT -i $INTIF2 -d $INTBC2 -j DROPl
$IPT -A OUTPUT -o $EXTIF -d $EXTBC -j DROPl
$IPT -A OUTPUT -o $INTIF1 -d $INTBC1 -j DROPl
$IPT -A OUTPUT -o $INTIF2 -d $INTBC2 -j DROPl
$IPT -A FORWARD -o $EXTIF -d $EXTBC -j DROPl
$IPT -A FORWARD -o $INTIF1 -d $INTBC1 -j DROPl
$IPT -A FORWARD -o $INTIF2 -d $INTBC2 -j DROPl
</source>}}

:Теперь проверим скрипт еще раз, чтобы убедиться в том, что мы не наделали синтаксических ошибок. Также отмечу, что мы используем определенные нами DROP1 цепочки (chains). Это означает, что отбрасываемые пакеты будут отмечены в журнале событий (log file).

===Блокировка доступа в локальную сеть из глобальной===
:Теперь мы блокируем доступ из глобальной сети в нашу локальную сеть, если мы не хотим что бы интернет провайдер назначал IP адреса для нашей внутренней сети.

{{Code||
<source lang="bash">
# Блокировать внешний доступ к локальной сети
# Это позволит остановить боевых кракеров от использования
# нашей сети как стартовой точки для других атак.
#
# Нижеприведенная строчка на человеческом языке будет выглядеть как
# "если входящий пакет, пришедший на наш внешний интерфейс,
# имеет адрес назначения, отличный от адреса нашего внешнего интерфейса,
# то этот пакет будет залогирован цепочкой DROPl, затем блокирован
# (не будет пропущен)."
$IPT -A INPUT -i $EXTIF -d ! $EXTIP -j DROPl
</source>}}

===Изолирование локальных сетей===
:Теперь мы предпримем некоторые действия для наших локальных сетей. Другими словами - все пакеты не относящиеся к локальным сетям должны быть блокированы.
{{Code||
<source lang="bash">
# Теперь мы должны заблокировать все пакеты не относящиеся к
# адресному пространству наших локальных сетей.
# Запомните, если вы подключите свой ноутбук к другому разъему,
# вам надо убедиться, что ваш сетевой адрес соответствует адресам этой сети.
#
# Первая локальная сеть
$IPT -A INPUT -i $INTIF1 -s ! $INTNET1 -j DROPl
$IPT -A OUTPUT -o $INTIF1 -d ! $INTNET1 -j DROPl
$IPT -A FORWARD -i $INTIF1 -s ! $INTNET1 -j DROPl
$IPT -A FORWARD -o $INTIF1 -d ! $INTNET1 -j DROPl
# Вторая локальная сеть
$IPT -A INPUT -i $INTIF2 -s ! $INTNET2 -j DROPl
$IPT -A OUTPUT -o $INTIF2 -d ! $INTNET2 -j DROPl
$IPT -A FORWARD -i $INTIF2 -s ! $INTNET2 -j DROPl
$IPT -A FORWARD -o $INTIF2 -d ! $INTNET2 -j DROPl
</source>}}

:Дальше мы сделаем некоторые дополнительные проверки исходящих пакетов и остановим все icmp пакеты кроме ping.
{{Code||
<source lang="bash">
# Дополнительная проверка
$IPT -A OUTPUT -o $EXTIF -s ! $EXTNET -j DROPl
# Блокируем исходящие ICMP (кроме PING)
$IPT -A OUTPUT -o $EXTIF -p icmp --icmp-type ! 8 -j DROPl
$IPT -A FORWARD -o $EXTIF -p icmp --icmp-type ! 8 -j DROPl
</source>}}

:Замечательно. Двигаемся дальше и проверяем скрипт на ошибки.

===Ports===
:Предполагая что у нас все сработало мы заткнем еще несколько портов, доступ по которым может представлять для нас серьезную опасность:
<source lang="bash">
# COMmon ports:
# 0 is tcpmux; SGI had vulnerability, 1 is common attack
# 13 is daytime
# 98 is Linuxconf
# 111 is sunrpc (portmap)
# 137:139, 445 is Microsoft
# SNMP: 161,2
# Squid flotilla: 3128, 8000, 8008, 8080
# 1214 is Morpheus or KaZaA
# 2049 is NFS
# 3049 is very virulent Linux Trojan, mistakable for NFS
# Common attacks: 1999, 4329, 6346
# Common Trojans 12345 65535
COMBLOCK="0:1 13 98 111 137:139 161:162 445 1214 1999 2049 3049 4329 6346 3128 8000 8008 8080 12345 65535"
# TCP ports:
# 98 is Linuxconf
# 512-515 is rexec, rlogin, rsh, printer(lpd)
# [very serious vulnerabilities; attacks continue daily]
# 1080 is Socks proxy server
# 6000 is X (NOTE X over SSH is secure and runs on TCP 22)
# Block 6112 (Sun's/HP's CDE)
TCPBLOCK="$COMBLOCK 98 512:515 1080 6000:6009 6112"

# UDP ports:
# 161:162 is SNMP
# 520=RIP, 9000 is Sangoma
# 517:518 are talk and ntalk (more annoying than anything)
UDPBLOCK="$COMBLOCK 161:162 520 123 517:518 1427 9000 9 6346 3128 8000 8008 8080 12345 65535"</source>
:После определения переменных окружения нам останется только пробежаться по ним циклом:
<source lang="bash">
echo -n "FW: Blocking attacks to TCP port"
for i in $TCPBLOCK;
do
echo -n "$i "
$IPT -A INPUT -p tcp --dport $i -j DROPl
$IPT -A OUTPUT -p tcp --dport $i -j DROPl
$IPT -A FORWARD -p tcp --dport $i -j DROPl
done
echo ""

echo -n "FW: Blocking attacks to UDP port "
for i in $UDPBLOCK;
do
echo -n "$i "
$IPT -A INPUT -p udp --dport $i -j DROPl
$IPT -A OUTPUT -p udp --dport $i -j DROPl
$IPT -A FORWARD -p udp --dport $i -j DROPl
done
echo ""</source>
:Ну что ж, теперь каждый раз, когда мы запускаем скрипт, эти строчки просто добавляются к уже существующим... что создаёт небольшой бардак. По этой причине мы собираемся перепрыгнуть в начало скрипта... сразу после переменных окружения для sed и grep, но перед переменными для EXTIP и EXTBC - там мы добавляем цикл, который производит очистку. Так мы будем уверены, что работаем в чистой среде. Нам не приходилось задуываться об этом ранее, потому что мы не имели возможности оттестить скрипт без обрыва соединения либо закрытия файрвола. Этот скрипт сначала выставляет всю политику в DROP, после чего очищает и удаляет наши цепочки. Чтобы убедиться, что мы по-прежнему можем залогиниться по ssh на наш сервер после того, как скрипт перезапустится, мы добавим цепочку INPUT для ssh. Пока что поставим её в конец скрипта. Это делается для того чтобы избежать открытия дыры в момент установки новых правил, что является довольно распространённой ошибкой:
<source lang="bash">
# Отказываем, потом принимаем: это уберёт дыру в момент,
# когда мы закрываем порты
$IPT -P INPUT DROP
$IPT -P OUTPUT DROP
$IPT -P FORWARD DROP

# Очищаем все существуещие цепочки и стираем дополнительные
CHAINS=`cat /proc/net/ip_tables_names 2>/dev/null`
for i in $CHAINS;
do
$IPT -t $i -F
done
for i in $CHAINS;
do
$IPT -t $i -X
done
$IPT -A INPUT -i $INTIF1 -p tcp --dport 22 --syn -m state --state NEW -j ACCEPT</source>

===Sysctl'ы===
:Сразу после этого мы запустим sysctl'ы для tcp_syncookies, icmp_echo_ignore_broadcasts, rp_filter и accept_source_routе. До этого момента многие правила, которые мы "проверяли", фактически не выполнялись. По сути, мы просто делали проверку синтаксических ошибок. Теперь наши правила будут выполняться в полной мере:
<source lang="bash">
echo 1 > /proc/sys/net/ipv4/tcp_syncookies
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_broadcasts

# Проверка адреса источника
for f in /proc/sys/net/ipv4/conf/*/rp_filter;
do
echo 1 > $f
done
# Отключаем роутинг источника IP и ICMP-редиректы
for f in /proc/sys/net/ipv4/conf/*/accept_source_route;
do
echo 0 > $f
done
for f in /proc/sys/net/ipv4/conf/*/accept_redirects;
do
echo 0 > $f
done
echo 1 > /proc/sys/net/ipv4/ip_forward
:Теперь мы собираемся добавить трекинг ftp-соединения, так что нам не доведётся наблюдать ошибки PASV при установке паков:
# Запускаем трекинг ftp-соединения
MODULES="ip_nat_ftp ip_conntrack_ftp"
for i in $MODULES;
do
echo "Добавляем модуль $i"
modprobe $i
done</source>

===Базовая конфигурация NAT===
:А сейчас возвратимся к концу нашего скрипта, поскольку мы собираемся открыть сервисы для хостов, находящихся за файерволом. Я включил следующие сервисы: IRC, MSN, ICQ, and NFS, FTP, domain,time и некоторые другие. Самое главное здесь то, что эти сервисы могут использоваться ТОЛЬКО ЗА файерволом.Таким образом никто не сможет их использовать по ftp внутри Вашей локальной сетки:
<source lang="bash">
IRC='ircd'
MSN=1863
ICQ=5190
NFS='sunrpc'
# Мы пользуемся sync!!
PORTAGE='rsync'
OpenPGP_HTTP_Keyserver=11371
# Все порты сервисов считываются из /etc/services
TCPSERV="domain ssh http https ftp ftp-data mail pop3 pop3s imap3 imaps imap2 time $PORTAGE $IRC $MSN $ICQ $OpenPGP_HTTP_Keyserver"
UDPSERV="domain time"
echo -n "FW: Allowing inside systems to use service:"
for i in $TCPSERV;
do
echo -n "$i "
$IPT -A OUTPUT -o $EXTIF -p tcp -s $EXTIP --dport $i --syn -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p tcp -s $INTNET1 --dport $i --syn -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p tcp -s $INTNET2 --dport $i --syn -m state --state NEW -j ACCEPT
done
echo ""

echo -n "FW: Allowing inside systems to use service:"
for i in $UDPSERV;
do
echo -n "$i "
$IPT -A OUTPUT -o $EXTIF -p udp -s $EXTIP --dport $i -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p udp -s $INTNET1 --dport $i -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p udp -s $INTNET2 --dport $i -m state --state NEW -j ACCEPT
done
echo ""</source>
:Теперь сделаем так, чтобы файервол позволил нам пинговать внешний мир. Для этого разрешим прохождение icmp-пакетов через внешний интерфейс:
<source lang="bash">
# Разрешаем внешнее пингование
$IPT -A OUTPUT -o $EXTIF -p icmp -s $EXTIP --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p icmp -s $INTNET1 --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p icmp -s $INTNET2 --icmp-type 8 -m state --state NEW -j ACCEPT

# Разрешим файерволу пинговать наши внутренние сетки:
$IPT -A OUTPUT -o $INTIF1 -p icmp -s $INTNET1 --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A OUTPUT -o $INTIF2 -p icmp -s $INTNET2 --icmp-type 8 -m state --state NEW -j ACCEPT</source>
:Теперь мы по умолчанию будем записывать в журнал все прочие запросы, но никак не будем на них реагировать. Все что нам надо было принять мы описали в начале наших правил. Так что заканчиваем правила блокировкой всего, что специально не разрешено:
<source lang="bash">
# Заблокируем все, что осталось:
$IPT -A INPUT -j DROPl
$IPT -A OUTPUT -j REJECTl
$IPT -A FORWARD -j DROPl</source>
:Итак, все сделано. я имею дружественные nmap и nessus для моих соединений с вышеописанным набором правил и ничего не препятствует использованию IRC, MSN, ICQ, и emerge sync.

==The full script==
:А сейчас, полноценный скрипт во всей своей красе (Заодно я поместил форвардинг ssh в более подходящее для него место):
<source lang="bash">
# Внешний интерфейс
EXTIF=ppp0
# Внутренний интерфейс
INTIF1=eth1
INTIF2=eth2
# Loop-устройство/localhost
LPDIF=lo
LPDIP=127.0.0.1
LPDMSK=255.0.0.0
LPDNET="$LPDIP/$LPDMSK"
# Переменные текстовых инструментов
IPT='/sbin/iptables'
IFC='/sbin/ifconfig'
G='/bin/grep'
SED='/bin/sed'
# Последнее (но немаловажное) - пользователи
JAMES=192.168.1.77
TERESA=192.168.2.77
# Deny вместо accept: предотвращает открытие "дыр"
# в то время, как мы закрываем порты и все такое
$IPT -P INPUT DROP
$IPT -P OUTPUT DROP
$IPT -P FORWARD DROP
# Сброс всех существующих цепочек и стирание персональных цепочек
CHAINS=`cat /proc/net/ip_tables_names 2>/dev/null`
for i in $CHAINS
do
$IPT -t $i -F
$IPT -t $i -X
done
echo 1 > /proc/sys/net/ipv4/tcp_syncookies
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_broadcasts
# Проверка адреса источника
for f in /proc/sys/net/ipv4/conf/*/rp_filter;
do
echo 1 > $f
done
# Запрет маршрутизации IP от источника и редиректов ICMP
for f in /proc/sys/net/ipv4/conf/*/accept_source_route;
do
echo 0 > $f
done
for f in /proc/sys/net/ipv4/conf/*/accept_redirects;
do
echo 0 > $f
done
echo 1 > /proc/sys/net/ipv4/ip_forward
# Установка переменных среды для внешнего интерфейса
EXTIP="`$IFC $EXTIF|$G addr:|$SED 's/.*addr:$[^ ]*$ .*/\1/'`"
#EXTBC="`$IFC $EXTIF|$G Bcast:|$SED 's/.*Bcast:$[^ ]*$ .*/\1/'`"
EXTBC="255.255.255.255"
EXTMSK="`$IFC $EXTIF|$G Mask:|$SED 's/.*Mask:$[^ ]*$/\1/'`"
EXTNET="$EXTIP/$EXTMSK"
#echo "EXTIP=$EXTIP EXTBC=$EXTBC EXTMSK=$EXTMSK EXTNET=$EXTNET"
echo "EXTIP=$EXTIP EXTBC=$EXTBC EXTMSK=$EXTMSK EXTNET=$EXTNET"
# Так как EXTBC отсутствует, я устанавливаю ее вручную как it to 255.255.255.255
# Это (надеюсь) послужит тем же целям
# Устанвка переменных среды для первого внутреннего интерфейса
INTIP1="`$IFC $INTIF1|$G addr:|$SED 's/.*addr:$[^ ]*$ .*/\1/'`"
INTBC1="`$IFC $INTIF1|$G Bcast:|$SED 's/.*Bcast:$[^ ]*$ .*/\1/'`"
INTMSK1="`$IFC $INTIF1|$G Mask:|$SED 's/.*Mask:$[^ ]*$/\1/'`"
INTNET1="$INTIP1/$INTMSK1"
echo "INTIP1=$INTIP1 INTBC1=$INTBC1 INTMSK1=$INTMSK1 INTNET1=$INTNET1"
# Установка переменных среды для второго внутреннего интерфейса
INTIP2="`$IFC $INTIF2|$G addr:|$SED 's/.*addr:$[^ ]*$ .*/\1/'`"
INTBC2="`$IFC $INTIF2|$G Bcast:|$SED 's/.*Bcast:$[^ ]*$ .*/\1/'`"
INTMSK2="`$IFC $INTIF2|$G Mask:|$SED 's/.*Mask:$[^ ]*$/\1/'`"
INTNET2="$INTIP2/$INTMSK2"
echo "INTIP2=$INTIP2 INTBC2=$INTBC2 INTMSK2=$INTMSK2 INTNET2=$INTNET2"
# Сейчас мы собираемся создать несколько собственных цепочек, результатом работы
# которых будет логгинг отброшенных пакетов. Это поможет нам избежать необходимости
# вводить команду log перед каждым отбрасыванием пакета, что мы хотим запротоколировать.
# Первыми идут лог отброшенных пакетов и собственно отброс, затем лог пакетов с отказами
# и собственно отказы.
# Отключаем сообщения о том, что цепочки уже существуют (чтобы перезапуск был без мусора)
$IPT -N DROPl 2> /dev/null
$IPT -A DROPl -j LOG --log-prefix 'DROPl:'
$IPT -A DROPl -j DROP
$IPT -N REJECTl 2> /dev/null
$IPT -A REJECTl -j LOG --log-prefix 'REJECTl:'
$IPT -A REJECTl -j REJECT
# Весь траффик от устройства loopback принимается
# если IP совпадает с любым из наших интерфейсов.
$IPT -A INPUT -i $LPDIF -s $LPDIP -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $EXTIP -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $INTIP1 -j ACCEPT
$IPT -A INPUT -i $LPDIF -s $INTIP2 -j ACCEPT
# Широковещательные пакеты блокируем
$IPT -A INPUT -i $EXTIF -d $EXTBC -j DROPl
$IPT -A INPUT -i $INTIF1 -d $INTBC1 -j DROPl
$IPT -A INPUT -i $INTIF2 -d $INTBC2 -j DROPl
$IPT -A OUTPUT -o $EXTIF -d $EXTBC -j DROPl
$IPT -A OUTPUT -o $INTIF1 -d $INTBC1 -j DROPl
$IPT -A OUTPUT -o $INTIF2 -d $INTBC2 -j DROPl
$IPT -A FORWARD -o $EXTIF -d $EXTBC -j DROPl
$IPT -A FORWARD -o $INTIF1 -d $INTBC1 -j DROPl
$IPT -A FORWARD -o $INTIF2 -d $INTBC2 -j DROPl
# Блокируем доступ к внутренней сети из WAN
# Это также призвано не дать нечестивым крякерам использовать нашу сетку
# в качестве отправной точки для атак на других людей
# Перевод с языка iptables:
# "если пришедшие на наружный интерфейс пакеты были отправлены не с выданного
# nefarious адреса, выкинуть их как горячую картошку"
$IPT -A INPUT -i $EXTIF -d ! $EXTIP -j DROPl
# А сейчас мы блокируем внутренние адреса, кроме двух, присвоенных нашим двум
# внутренним интерфейсам.....только помните, что если вы воткнете свой лэптоп или
# какой другой pc в напрямую в одну из этих сетевых карт, то нужно удостовериться,
# что они имеют именно эти IP-адреса или добавить соответствующий адрес отдельно.
# Первый интерфейс/первая внутренняя сеть
$IPT -A INPUT -i $INTIF1 -s ! $INTNET1 -j DROPl
$IPT -A OUTPUT -o $INTIF1 -d ! $INTNET1 -j DROPl
$IPT -A FORWARD -i $INTIF1 -s ! $INTNET1 -j DROPl
$IPT -A FORWARD -o $INTIF1 -d ! $INTNET1 -j DROPl
# Второй интерфейс/вторая внутренняя сеть
$IPT -A INPUT -i $INTIF2 -s ! $INTNET2 -j DROPl
$IPT -A OUTPUT -o $INTIF2 -d ! $INTNET2 -j DROPl
$IPT -A FORWARD -i $INTIF2 -s ! $INTNET2 -j DROPl
$IPT -A FORWARD -o $INTIF2 -d ! $INTNET2 -j DROPl
# Дополнительная Egress-проверка
$IPT -A OUTPUT -o $EXTIF -s ! $EXTNET -j DROPl
# Блокируем исходящиие пакеты ICMP (за исключением PING)
$IPT -A OUTPUT -o $EXTIF -p icmp --icmp-type ! 8 -j DROPl
$IPT -A FORWARD -o $EXTIF -p icmp --icmp-type ! 8 -j DROPl
# печально известные порты:
# 0 - tcpmux; у SGI есть уязвимость, через которую можно атаковать
# 13 - daytime
# 98 - Linuxconf
# 111 - sunrpc (portmap)
# 137:139, 445 - Microsoft
# SNMP: 161,2
# Флотилия Squid: 3128, 8000, 8008, 8080
# 1214 - Morpheus или KaZaA
# 2049 - NFS
# 3049 - очень заразный троян для Linux, часто путаемый с NFS
# Часто атакуемые: 1999, 4329, 6346
# Частые трояны 12345 65535
COMBLOCK="0:1 13 98 111 137:139 161:162 445 1214 1999 2049 3049 4329 6346 3128 8000 8008 8080 12345 65535"
# Порты TCP:
# 98 - Linuxconf
# 512-515 - rexec, rlogin, rsh, printer(lpd)
# [очень серьезеные уязвимости; продолжаются ежедневные атаки]
# 1080 - прокси-серверы Socks
# 6000 - X (ЗАМЕЧАНИЕ. X через SSH - безопасен, и работает на порту TCP 22)
# Блокировка 6112 (CDE у Sun и HP)
TCPBLOCK="$COMBLOCK 98 512:515 1080 6000:6009 6112"
# Порты UDP:
# 161:162 - SNMP
# 520=RIP, 9000 - Sangoma
# 517:518 - talk и ntalk (самые надоедливые)
UDPBLOCK="$COMBLOCK 161:162 520 123 517:518 1427 9000"
echo -n "FW: Blocking attacks to TCP port"
for i in $TCPBLOCK;
do
echo -n "$i "
$IPT -A INPUT -p tcp --dport $i -j DROPl
$IPT -A OUTPUT -p tcp --dport $i -j DROPl
$IPT -A FORWARD -p tcp --dport $i -j DROPl
done
echo ""
echo -n "FW: Blocking attacks to UDP port "
for i in $UDPBLOCK;
do
echo -n "$i "
$IPT -A INPUT -p udp --dport $i -j DROPl
$IPT -A OUTPUT -p udp --dport $i -j DROPl
$IPT -A FORWARD -p udp --dport $i -j DROPl
done
echo ""
# Открываем отлеживание соединений по ftp
MODULES="ip_nat_ftp ip_conntrack_ftp"
for i in $MODULES;
do
echo "Inserting module $i"
modprobe $i
done
# Защищаем некоторые распространенные клиенты для чата.
# Уберите из списка допустимых для пущей безопасности.
IRC='ircd'
MSN=1863
ICQ=5190
NFS='sunrpc'
# Нам нужно синхронизировать данные!!
PORTAGE='rsync'
OpenPGP_HTTP_Keyserver=11371
# Все порты сервисов читаются из /etc/services
TCPSERV="domain ssh http https ftp ftp-data mail pop3 pop3s imap3 imaps imap2 time $PORTAGE $IRC $MSN $ICQ $OpenPGP_HTTP_Keyserver" UDPSERV="domain time"
echo -n "FW: Allowing inside systems to use service:"
for i in $TCPSERV;
do
echo -n "$i "
$IPT -A OUTPUT -o $EXTIF -p tcp -s $EXTIP --dport $i --syn -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p tcp -s $INTNET1 --dport $i --syn -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p tcp -s $INTNET2 --dport $i --syn -m state --state NEW -j ACCEPT
done
echo ""
echo -n "FW: Allowing inside systems to use service:"
for i in $UDPSERV;
do
echo -n "$i "
$IPT -A OUTPUT -o $EXTIF -p udp -s $EXTIP --dport $i -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p udp -s $INTNET1 --dport $i -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p udp -s $INTNET2 --dport $i -m state --state NEW -j ACCEPT
done
echo ""
# Разрешается ping наружу
$IPT -A OUTPUT -o $EXTIF -p icmp -s $EXTIP --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF1 -p icmp -s $INTNET1 --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A FORWARD -i $INTIF2 -p icmp -s $INTNET2 --icmp-type 8 -m state --state NEW -j ACCEPT
# Файерволу разрешается ping внутренних систем
$IPT -A OUTPUT -o $INTIF1 -p icmp -s $INTNET1 --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A OUTPUT -o $INTIF2 -p icmp -s $INTNET2 --icmp-type 8 -m state --state NEW -j ACCEPT
$IPT -A INPUT -i $INTIF1 -p tcp --dport 22 --syn -m state --state NEW -j ACCEPT
$IPT -t nat -A PREROUTING -j ACCEPT
$IPT -t nat -A POSTROUTING -o $EXTIF -s $INTNET1 -j MASQUERADE
$IPT -t nat -A POSTROUTING -o $EXTIF -s $INTNET2 -j MASQUERADE
$IPT -t nat -A POSTROUTING -j ACCEPT
$IPT -t nat -A OUTPUT -j ACCEPT
$IPT -A INPUT -p tcp --dport auth --syn -m state --state NEW -j ACCEPT
$IPT -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
$IPT -A OUTPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
$IPT -A FORWARD -m state --state ESTABLISHED,RELATED -j ACCEPT
# Заблокировать и запротоколировать все, что мы могли забыть.
$IPT -A INPUT -j DROPl
$IPT -A OUTPUT -j REJECTl
$IPT -A FORWARD -j DROPl</source>

Заглавная страница

2011-12-24T15:34:40Z

Langator:

__NOTOC__
<div ALIGN=JUSTIFY>



<div style="width:57%; padding-right: 3%; float: left;">


== О проекте Ай Да Linux ==
<div style="float: right;">[[File:Larry-hi.png|moo|link=]]</div>
{{Главная страница}}


== Getting started ==
Вы можете редактировать и создавать страницы на этой Wiki.

Для навигации по сайту можно воспользоваться поиском, посмотреть [[Служебная:AllPages|все]] имеющиеся статьи или [[%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:Random|случайную]].
Прежде чем редактировать или создавать новые страницы, пожалуйста, обратитесь к [[Справка:Содержание|справке]]. Так же можно заглянуть в [http://meta.wikimedia.org/wiki/Help:Contents MediaWiki User's Guide] содержащий информацию о работе wiki.

Если у Вас возникнут какие-либо вопросы, Вы всегда можете написать нам по адресу [mailto:aidalinux@gmail.com aidalinux@gmail.com].

</div>



<div style="width: 40%; float: left;">


== News ==
{{News|17.12.2011|Добро пожаловать на Ай Да Linux Wiki|
Идет активное формирование главной страницы Wiki, пожелания и предложения оставляйте на [[%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5:%D0%97%D0%B0%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0 | странице обсуждения]].
}}



== Недавно добавленные страницы ==

</div>



</div>

Справка:Содержание

2011-12-24T15:24:25Z

Langator: /* Смотрите также */

== Чтение == 


* [[Help:Navigation|Навигация]]


* [[Help:Searching|Поиск]]


* [[Help:Tracking changes|Отслеживание изменений]]


* [[Help:Watchlist|Список наблюдения]]

== Пользовательские настройки == 


* [[Help:Preferences|Настройки]]


* [[Help:User page|Страница пользователя]]


* [[Help:Signatures|Подпись]]

== Редактирование ==



* [[Help:Editing pages|Редактирование страниц]]
* [[Help:Starting a new page|Создание новой страницы]]
* [[Help:Formatting|Форматирование]]
* [[Help:Links|Ссылки]]
* [[Help:Translating|Перевод]]
* [[Help:Talk pages|Обсуждение]]

=== Расширенное редактирование ===
* [[Help:Images|Изображения]]
* [[Help:Tables|Таблицы]]
* [[Help:Categories|Категории]]
* [[Help:Subpages|Подкатегории]]
* [[Help:Managing files|Управление файлами]]
* [[Help:Moving a page|Перемещение (переименование) страниц]]
* [[Help:Redirects|Перенаправление]]
* [[Help:Deleting a page|Удаление страниц]]
* [[Help:Protected pages|Защита страниц]]
* [[Help:Patrolled edits|проверенные правки]]

* [[Help:Templates|Шаблоны]]
* [[Help:Magic words|Magic words]]
* [[Help:Template sandbox and test cases|Песочница]]

* [[Help:Namespaces|Пространство имен]]
* [[Help:Special pages|Специальные страницы]]

* [[Help:External searches|Внешний поиск]]
* [[Help:Bots|Боты]]

=== Шаблоны ===
* [[Special:PrefixIndex/Template:|Все шаблоны]]
** [[:Category:Formatting templates|Форматирование шаблонов]]
** [[:Category:InfoBox templates|Шаблон InfoBox]]
** [[:Category:Templates for templates|Шаблоны для шаблонов]]
** [[:Category:License templates|Шаблоны лицензий]]

== Смотрите также ==
* [[metawikipedia:Help:Contents|Help:Contents]] на meta.wikimedia.org
* [http://wiki.gentoo.org/wiki/Help:Contents Help:Contents] на wiki.gentoo.org
[[Category:Help]]

Категория:License templates

2011-12-24T15:20:43Z

Langator: Новая страница: «Category:Templates»

[[Category:Templates]]

Категория:Templates for templates

2011-12-24T15:20:05Z

Langator: Новая страница: «Category:Templates»

[[Category:Templates]]

Категория:InfoBox templates

2011-12-24T15:19:21Z

Langator: Новая страница: «Category:Templates»

[[Category:Templates]]

Категория:Formatting templates

2011-12-24T15:18:49Z

Langator: Новая страница: «Category:Templates»

[[Category:Templates]]

Справка:Bots

2011-12-24T15:18:21Z

Langator: Новая страница: «A '''bot''' is a computer program that automatically retrieves or updates wiki pages when it is executed. In general, bots are used for repetitive maintenance tasks,...»

A '''bot''' is a computer program that automatically retrieves or updates wiki pages when it is executed. In general, bots are used for repetitive maintenance tasks, whose volume and characteristics are too large to be performed manually by users.

Developing and executing bots is normally outside the role of normal users, requires programming experience and must be done in coordination with the wiki's admins.

By default, bot edits are hidden in [[Special:RecentChanges|{{ns:special}}:{{MediaWiki:Recentchanges}}]].

== Framework and interface for bot development ==
Bots do not access the wiki through the normal graphical user interface. MediaWiki has an API (Application Programming Interface) available for this purpose. An API is a protocol for standardised communication between two computer programs. Check [[mw:API:Client code|API:Client code]] for more information.

To access a wiki through the API a bot must have a user account, which has been granted 'bot' permissions.

=== pywikipediabot ===
[[metawikipedia:pywikipediabot|pywikipediabot]] provides a framework for the development of bots, which are commonly used to perform maintenance tasks such as adding a footer to some categorized pages ([[mw:pywikipediabot/add_text.py|add_text.py]]), adding some [[Help:Links|wikilinks]] ([[metawikipedia:pywikipediabot/replace.py|replace.py]]), moving old contents of [[Help:Talk pages|talk pages]] to [[Help:Subpages|subpages]] ([[metawikipedia:pywikipediabot/archivebot.py|archivebot.py]]), editing [[Help:Categories|categories]] ([[metawikipedia:pywikipediabot/category.py|category.py]]), or managing [[Help:Templates|templates]] ([[metawikipedia:pywikipediabot/template.py|template.py]]).

== See also ==
* [[metawikipedia:Bot|Bot]] on meta.wikimedia.org

[[Category:Help]]

Справка:External searches

2011-12-24T15:17:50Z

Langator: Новая страница: «It is possible to create an external searches of a topic using key words using a template. For example, this is something that would work for Google: <pre style="ov...»

It is possible to create an external searches of a topic using key words using a template.

For example, this is something that would work for Google:
<pre style="overflow: auto"><nowiki>
[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{{1|Wiki}}} {{{1|Google}}}]
<noinclude>
==Usage==
Allows to establish a link to a search query at the Google search engine:
<div style="display:table; width:auto;"><pre>
{{Google|Term1+Term2+Term3}}
</pre></div>
[[Category:Template|Google]]
</noinclude></nowiki></pre>

The usage is very simple and easy to use. <nowiki>{{Google|firstTerm+Second+etc}}</nowiki>

It is also possible to do phrases by using %22Term1+Term2+etc%22

* External searches are useful where an article requires certain keywords to make an effective search.
* For the editor it allows making searches of web more quickly and painlessly.

Other applications of the template include searching Forums, for bug reports of the same type for software development wikis where the wiki and forum work together.

Note: Wikipedia has an [[Help:Links#Interwiki_links|interwiki prefix]] with a similar effect, so you can link to google results with <nowiki>[[Google:firstTerm+Second+etc]]</nowiki>, although templates are still useful for linking other search engines.

For a clear advantage of implementing a template over the default Google interwiki prefix, consider the following, modified example:

<pre style="overflow: auto"><nowiki>
[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{urlencode:{{{1|Wiki}}}}} {{{1|Google}}}]
<noinclude>
==Usage==
Allows to establish a link to a search query at the Google search engine:
* <code>{{Google|Term1 Term2 Term3}}</code>
* <code>{{Google|"a phrase"}}</code>
[[Category:Template|Google]]
</noinclude></nowiki></pre>

Note the application of MediaWiki [[Help:Magic words|magic word]] <code>urlencode</code>. This grants us the convenience and elegance of entering the query string in a Wikipedia article in the same literal form we would enter it in Google search box, including spaces and quotation marks instead of representing them indirectly with <code>+</code> and <code>%20</code>.

[[Category:Help]]

Справка:Special pages

2011-12-24T15:17:06Z

Langator: Новая страница: «'''Special pages''' are pages that are created by the software on demand. They are located in their own namespace ''Special:'' and are not editab...»

'''Special pages''' are pages that are created by the software on demand. They are located in their own [[Help:Namespaces|namespace]] ''Special:'' and are not editable directly as other pages.

Some special pages depend on the [[Help:Preferences|preferences]] that have been set by a user, e.g. the number of titles which is displayed on a user's [[Help:Watchlist|watchlist]].

== List of special pages ==
Clicking the link ''[[Special:Specialpages]]'' will take you to a list of all special pages on a wiki. Such a link is often accessible in the [[Help:Navigation#Toolbox|toolbox]] on the left hand panel. Some special pages can be [[Help:Transclusion|transcluded]].

* [[Help:New images|New images]] (includable)
* [[Help:New pages|New pages]] (includable)
* [[Help:Preferences|Preferences]]
* [[Help:Random page|Random page]]
* [[Help:Recent changes|Recent changes]] (includable)
* [[Help:Watchlist|Watchlist]]
* ...

[[Category:Help]]

Справка:Namespaces

2011-12-24T15:16:02Z

Langator: Новая страница: «Pages on a MediaWiki wiki are grouped into collections called "'''namespaces'''", which differentiate between the purpose of the pages at a high level. Pages in cer...»

Pages on a MediaWiki wiki are grouped into collections called "'''namespaces'''", which differentiate between the purpose of the pages at a high level. Pages in certain namespaces can also have special properties or behave differently when they interact with other pages.

Namespaces are indicated in page titles by prefixing the page name with "<tt>namespace:</tt>", so the prefix "<tt>{{NAMESPACE}}:</tt>" in this page's title ("{{FULLPAGENAME}}") indicates that this page is in the {{NAMESPACE}} namespace. Note, however, that colons and prefixes can also appear in page titles ''without'' indicating a namespace: The page "Foo:{{PAGENAME}}" is a page located in the [[#0: (Main)|mainspace]] because the namespace "Foo" does not exist. Similarly the page "{{NAMESPACE}}:Foo:{{PAGENAME}}" is in the "{{NAMESPACE}}" namespace.

== Standard namespaces ==
The standard MediaWiki installation has sixteen namespaces which can contain user-generated content; there are also two special namespaces which contain pages created 'on the fly' by the MediaWiki software. The standard namespaces are organised in pairs, with each pair containing a 'subject namespace' and a 'discussion namespace'. The namespaces are numbered from zero such that all subject namespaces have even indices, and all talk namespaces have odd indices.

==== -2: {{ns:-2}} ====
This namespace is an alias used for direct linking to media files: the link [[{{ns:-2}}:Wiki.png]] links to just the image rather than the image description page, which would be [[:{{ns:6}}:Wiki.png]].

==== -1: {{ns:-1}} ====
This namespace is used to group [[Help:Special pages|special pages]], reports and interfaces that are generated 'on demand' by MediaWiki and which are not directly editable. It is not possible to create pages in this namespace except by modifying or extending the MediaWiki software.

==== 0: (Main) ====
Namespace zero is the 'null' namespace, commonly called the "main namespace" or "mainspace". This namespace typically contains the bulk of the [[mw:Manual:$wgContentNamespaces|content pages]] in a wiki. This namespace generally has no special properties.

==== 1: {{ns:1}} ====
The "Talk" namespace is the discussion namespace attached to the mainspace. It has no special properties.

==== 2: {{ns:2}} ====
Each user has a corresponding page in the {{ns:2}} namespace, which is linked to from edit histories, watchlists, recent changes, etc; wherever an individual user is uniquely identified. This page, and subpages of it, can be used by users to record information about themselves or to test and draft new content. Pages of the form "<tt style="whitespace:nowrap">{{ns:2}}:''UserName''/Foo'''.js'''</tt>" or "<tt style="whitespace:nowrap">{{ns:2}}:''UserName''/Foo'''.css'''</tt>" can only be edited by the user themselves or by administrators.

==== 3: {{ns:3}} ====
This namespace is the talkspace associated with the {{ns:2}} namespace. Pages in this namespace are mainly used to leave messages for particular users or inform them of discussions that may be of interest to them. To facilitate this, when a page "{{ns:3}}:UserName" is edited, whenever the user 'UserName' loads a page, a notice is displayed at the top of the page informing them of the edit:
<div class="usermessage plainlinks">You have [[{{ns:3}}:UserName|new messages]] ([{{fullurl:{{ns:3}}:UserName&diff=cur}} last change]).</div>

This notice continues to appear until the user loads their user talk page to read the message.

==== 4: {{ns:4}} ====
This namespace is normally used for meta-discussions related to the operation and development of the wiki. It has no special properties.

==== 5: {{ns:5}} ====
This is a talk namespace that is normally used for discussions related to the associated subject pages. It has no special properties.

==== 6: {{ns:6}} ====
[[Image:Wiki.png|right]]
The {{ns:6}} namespace is used to store metadata for images, videos, sound files and other media accessed via the {{ns:-2}} namespace. Each file has a corresponding page in the {{ns:6}} namespace which is often used to hold licensing data. Linking ''directly'' to a page in this namespace instead includes the media file inline in the page: <tt style="white-space:nowrap"><nowiki>[[</nowiki>{{ns:6}}<nowiki>:Wiki.png|right]]</nowiki></tt> produces the image to the right. See [[Help:Images]] for more details of this link syntax. To create an [[Help:Links|internal link]] to the file page, you need to add a colon to the front of the namespace: <tt style="white-space:nowrap"><nowiki>[[:</nowiki>{{ns:6}}<nowiki>:Wiki.png|right]]</nowiki></tt> produces [[:{{ns:6}}:Wiki.png]].
The standard MediaWiki installation has alias "Image" for {{ns:6}} namespace - See [[Help:Namespaces#Namespace aliases|Namespace aliases]].

==== 7: {{ns:7}} ====
This is a talk namespace that is normally used for discussions related to the associated media files. It has no special properties.

==== 8: {{ns:8}} ====
The MediaWiki namespace is used to hold system messages and other important content. For instance, the page [[{{ns:8}}:Vector-view-edit]] contains the text that fills the "Edit" tab at the top of every page. If that page exists, it overrides the default content, which is "edit this page". Similarly, [[{{ns:8}}:Common.css]] is the system message which holds the [[wikipedia:Cascading Style Sheets|CSS]] code that is loaded for all users for each page. It has the special property that the entire namespace is fully protected and can only be edited by administrators.

==== 9: {{ns:9}} ====
This is a talk namespace that is normally used for discussions related to the associated system messages. It has no special properties.

==== 10: {{ns:10}} ====
The {{ns:10}} namespace is used to hold [[Help:Templates|templates]], blocks of text or wikicode that are intended to be transcluded into several other pages. To facilitate this it has the special property that it is the ''default'' namespace for transclusions: the wikicode <tt style="white-space:nowrap"><nowiki>{{Foo}}</nowiki></tt> is equivalent to <tt style="white-space:nowrap"><nowiki>{{</nowiki>'''{{ns:10}}:'''<nowiki>Foo}}</nowiki></tt>.

==== 11: {{ns:11}} ====
This is a talk namespace that is normally used for discussions related to the associated template pages. It has no special properties.

==== 12: {{ns:12}} ====
The {{ns:12}} namespace is usually used to hold help files, instructions and 'how-to' guides. It has no special properties.

==== 13: {{ns:13}} ====
This is a talk namespace that is normally used for discussions related to the associated help pages. It has no special properties.

==== 14: {{ns:14}} ====
The {{ns:14}} namespace contains [[Help:Categories|categories]], dynamic lists of other pages. To facilitate this, linking ''directly'' to a category page does not output an inline link, but instead includes the page into the associated category page. So the code <tt style="white-space:nowrap"><nowiki>[[</nowiki>{{ns:14}}<nowiki>:Help]]</nowiki></tt> causes a category link to appear at the bottom of the page (at the bottom in the box marked "Categories"). Clicking on that link takes you to the category page, where this page is visible in the category list. To create an inline link to a category page, you need to add a colon to the front of the namespace: <tt style="white-space:nowrap"><nowiki>[[:</nowiki>{{ns:14}}<nowiki>:Help]]</nowiki></tt> produces [[:{{ns:14}}:Help]]. See [[Help:Categories]] for more details on category link syntax.

==== 15: {{ns:15}} ====
This is a talk namespace that is normally used for discussions related to the associated category pages. It has no special properties.

== Identifying namespaces ==
There are a number of ways by which the namespace of a particular page can be identified:

;Magic words
The [[Help:Magic words|magic word]] <tt><nowiki>{{NAMESPACE}}</nowiki></tt> returns the value of the namespace the page is in.

;JavaScript
The JavaScript variable <tt>wgCanonicalNamespace</tt> contains the full namespace name. The variable <tt>wgNamespaceNumber</tt> contains the numerical index of the namespace.

;CSS
The <tt><nowiki><body></nowiki></tt> tag of the HTML page output is given two CSS classes that vary by namespace: A class <tt>ns-#</tt>, where # is the index of the namespace, and <tt>ns-XXX</tt>, where XXX is "<tt>subject</tt>" for all [[mw:Manual:Namespace#Subject and talk namespaces|subject namespaces]], "<tt>special</tt>" for pages in the {{ns:-1}} namespace, and "<tt>talk</tt>" for [[mw:Manual:Namespace#Subject and talk namespaces|talk namespaces]]. So CSS code such as the following can be used to change the appearance of an object based on its namespace:
<source lang=css>
.ns-subject a
{ /* Almost all links on subject pages to be green. */
color: #00FF00;
}
.ns-talk a
{ /* Links on talk pages to be blue. */
color: #0000FF;
}
.ns-3 a
{ /* and links on user talk pages to be red */
color: #FF0000;
}
</source>

;API
You can get a complete list of all the namespaces used on this wiki from the API:
:{{SERVER}}/w/api.php?action=query&meta=siteinfo&siprop=namespaces

== See also ==
* [[mw:Manual:Namespace|Manual:Namespace]] on mediawiki.org
* [[mw:Manual:Using custom namespaces|Manual:Using custom namespaces]] on mediawiki.org

[[Category:Help]]

Справка:Template sandbox and test cases

2011-12-24T15:15:20Z

Langator: Новая страница: «Templates are a very powerful feature of MediaWiki, but mistakes can be easily made, even by experienced users. Complex templates should therefore...»

[[Help:Templates|Templates]] are a very powerful feature of MediaWiki, but mistakes can be easily made, even by experienced users. Complex templates should therefore be accompanied by '''[[wikipedia:Sandbox (software development)|sandboxes]]''' and '''[[wikipedia:test case|test cases]]''' to prevent bugs.

== For what kind of templates ==
It is recommended to apply the test case pattern to templates using [[mw:Help:Extension:ParserFunctions|ParserFunctions]] that can generate very different looking output, such as the ones that take many parameters, or the ones that have many branches of the <tt>#switch</tt> operator.

For navigational boxes, of which the outputs are almost identical on each transcluding page, the benefit may not outweight the time and effort.

Any template that is transcluded in thousands of pages should of course be tested before an edit is made.

== Prerequisite ==
The template must be properly documented following [[wikipedia:Wikipedia:Template documentation|Wikipedia:Template documentation]].

Furthermore, the template should not have too many interleaving <tt><nowiki><includeonly></nowiki></tt> and <tt><nowiki><noinclude></nowiki></tt> blocks. Ideally there is only one <tt><nowiki><noinclude></nowiki></tt> block, placed at the bottom of the template, and containing the [[Template:Documentation|<nowiki>{{Documentation}}</nowiki>]] template.

== How to create /sandbox and /testcases subpages ==
1: Suppose your template is named <tt>Template:X</tt>. Create sandbox and testcases subpages by clicking on the "create" links in the Note box under the documentation. The subpages will have the names <tt>Template:X/sandbox</tt> and <tt>Template:X/testcases</tt> and are preloaded with some default contents. When these subpages are present, the Note box automatically provide links to them. Note that "/sandbox" and "/testcases" are spelled in all lower-case.

2: Copy only the code (everything that is not surrounded by <tt><nowiki><noinclude></nowiki></tt>) from your <tt>Template:X</tt> to <tt>Template:X/sandbox</tt>. Keep the [[Template:Template sandbox notice|<nowiki>{{Template sandbox notice}}</nowiki>]] line at the bottom:

:<code style="display:table; line-height:1.2em;"><noinclude> <nowiki>{{Template sandbox notice}}</nowiki> </noinclude></code>

In other words, the result should be:

:<code style="display:table; line-height:1.2em;">[-- Template code --]<noinclude> <nowiki>{{Template sandbox notice}}</nowiki> </noinclude></code>

{{Note|The template code must start directly before and touch the <code></noinclude></code> tag. Any blank space or newlines between the template code and the <code></noinclude></code> tag can cause the template to render unwanted spaces or newlines when used.}}

3: Copy a few transcluding examples from articles (<tt><nowiki>{{X | .... }}</nowiki></tt>) to your <tt>Template:X/testcases</tt>. In the test case subpage, duplicate each example, and for '''one copy''' of each example, replace <tt>X</tt> with <tt>X/sandbox</tt>. This is done so that you may compare the old and new outputs side by side in the future. Lastly, add the following line at the beginning of the test case page. It does not matter how many blank lines you put around it:

:<code style="display:table; line-height:1.2em;"><nowiki>{{Template testcases notice}}</nowiki></code>

4: Thus <tt>Template:X/testcases</tt> will look like this:
<pre>
{{Template testcases notice}}

{{X | foo}}
{{X/sandbox | foo}}

{{X | bar}}
{{X/sandbox | bar}}
</pre>

== How to use them subsequently ==
* Sync sandbox from the real template (i.e. step 2 above)
* Have fun editing the sandbox
* Verify the test cases
* If everything looks good, copy the code from the sandbox to the real template

If you chose not to compare the new and old outputs side by side described at the last bullet point of the previous section, it is recommended to use a tabbed browser and open the test case subpage before changing the sandbox, and another after changing the sandbox. This can ensure that the differences are compared accurately.

== Example ==
* [[Template:GenericCmd|<nowiki>{{GenericCmd}}</nowiki>]]

== See also ==
* [[Template:Template sandbox notice|<nowiki>{{Template sandbox notice}}</nowiki>]] – To put at the bottom of /sandbox pages.
* [[Template:Template testcases notice|<nowiki>{{Template test cases notice}}</nowiki>]] – To put on top of /testcases pages.

[[Category:Help]]

Справка:Magic words

2011-12-24T15:13:36Z

Langator: Новая страница: «'''Magic words''' are strings of text that MediaWiki associates with a return value or function, such as time, site details, or page names. There are three general ...»

'''Magic words''' are strings of text that MediaWiki associates with a return value or function, such as time, site details, or page names.

There are three general types of magic words:
* '''[[#Behavior switches|Behavior switches]]''': these are uppercase words surrounded by double underscores, e.g. '''<code><nowiki>__FOO__</nowiki></code>'''
* '''[[#Variables|Variables]]''': these are uppercase words surrounded by double braces, e.g. '''<code><nowiki>{{FOO}}</nowiki></code>'''. As such, they look a lot like [[Help:Templates|templates]].
* '''[[#Parser functions|Parser functions]]''': these take parameters and are either of the form '''<code><nowiki>{{foo:...}}</nowiki></code>''' or '''<code><nowiki>{{#foo:...}}</nowiki></code>'''. See also [[mw:Help:Extension:ParserFunctions|Help:Extension:ParserFunctions]].

Page-dependent magic words will affect or return data about the ''current'' page (by default), even if the word is added through a transcluded template or included system message.

== Behavior switches ==
A behavior switch controls the layout or behavior of the page and can often be used to specify desired omissions and inclusions in the content.

{| class="wikitable"
|-
! style="background:#A7C1F2" | Word
! style="background:#A7C1F2" | Description
|-
! style="background:#8DA7D6; color:black;" colspan="3"| '''Table of contents'''
|-
| <code><nowiki>__NOTOC__</nowiki></code>
| Hides the table of contents (TOC).
|-
| <code><nowiki>__FORCETOC__</nowiki></code>
| Forces the table of content to appear at its normal position (above the first header).
|-
| <code><nowiki>__TOC__</nowiki></code>
| Places a table of contents at the word's current position (overriding <code><nowiki>__NOTOC__</nowiki></code>). If this is used multiple times, the table of contents will appear at the first word's position. It is possible to suppress the auto-generated section numbers, if the proper class exists locally at [[MediaWiki:Common.css]], defined as <code>.tocnumber { display: none; }</code>.
|-
! style="background:#8DA7D6; color:black;" colspan="3"| '''Editing'''
|-
| <code><nowiki>__NOEDITSECTION__</nowiki></code>
| Hides the section edit links beside headings.
|-
| <code><nowiki>__NEWSECTIONLINK__</nowiki></code>
| Adds a link "+" beside the "edit" tab for adding a new section on a non-talk page (see [[metawikipedia:Help:Section#Adding a section at the end|Adding a section to the end]] (meta.wikimedia.org)).
|-
| <code><nowiki>__NONEWSECTIONLINK__</nowiki></code>
| Removes the link beside the "edit" tab on pages in talk namespaces.
|-
! style="background:#8DA7D6; color:black;" colspan="3"| '''Categories'''
|-
| <code><nowiki>__NOGALLERY__</nowiki></code>
| Used on a category page, replaces thumbnails in the category view with normal links.
|-
| <code><nowiki>__HIDDENCAT__</nowiki></code>
| Used on a category page, hides the category from the lists of categories in its members and parent categories (there is an option in the [[Help:Preferences|user preferences]] to show them).
|-
! style="background:#8DA7D6; color:black;" colspan="3"| '''Language conversion'''
|-
| <code><nowiki>__NOCONTENTCONVERT__</nowiki></code> <code><nowiki>__NOCC__</nowiki></code>
| On wikis with language variants, don't perform any content language conversion (character and phase) in article display; for example, only show Chinese (zh) instead of variants like zh_cn, zh_tw, zh_sg, or zh_hk.
|-
| <code><nowiki>__NOTITLECONVERT__</nowiki></code> <code><nowiki>__NOTC__</nowiki></code>
| On wikis with language variants, don't perform language conversion on the title (all other content is converted).
|-
! style="background:#8DA7D6; color:black;" colspan="3"| '''Other'''
|-
| <code><nowiki>__START__</nowiki></code>
| No effect.
|-
| <code><nowiki>__INDEX__</nowiki></code>
| Tell search engines to index the page (overrides [[mw:Manual:$wgArticleRobotPolicies|$wgArticleRobotPolicies]], but not robots.txt).
|-
| <code><nowiki>__NOINDEX__</nowiki></code>
| Tell search engines not to index the page (ie, do not list in search engines' results).
|-
| <code><nowiki>__STATICREDIRECT__</nowiki></code>
| On redirect pages, don't allow MediaWiki to automatically update the link when someone moves a page and checks "Update any redirects that point to the original title".
|}

== Variables ==
Variables return information about the current page, wiki, or date. Their syntax is similar to [[Help:Templates|templates]]. Variables marked as "'''[expensive]'''" are tracked by the software, and the number that can be included on a page is limited.

If a template name conflicts with a variable, the variable will be used (so to transclude the template "<code><nowiki>PAGENAME</nowiki></code>" you would need to write <code><nowiki>{{</nowiki>{{ns:10}}:PAGENAME<nowiki>}}</nowiki></code>). In some cases, adding parameters will force the parser to invoke a template; for example, <code><nowiki>{{CURRENTDAYNAME|x}}</nowiki></code> transcludes "<code><nowiki>{{Template:CURRENTDAYNAME}}</nowiki></code>", ''not'' the variable.

=== Date and time ===
The following variables return the current date and time in UTC.

Due to MediaWiki and browser caching, these variables frequently show when the page was ''cached'' rather than the current time. The date and time magic words are formatted in the english language.

{| class="wikitable"
|-
! style="background:#A7C1F2" | Variable
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Year'''
|-
| <code><nowiki>{{CURRENTYEAR}}</nowiki></code>
| {{CURRENTYEAR}}
| Year
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Month'''
|-
| <code><nowiki>{{CURRENTMONTH}}</nowiki></code>
| {{CURRENTMONTH}}
| Month (zero-padded number)
|-
| <code><nowiki>{{CURRENTMONTHNAME}}</nowiki></code>
| {{CURRENTMONTHNAME}}
| Month (name)
|-
| <code><nowiki>{{CURRENTMONTHNAMEGEN}}</nowiki></code>
| {{CURRENTMONTHNAMEGEN}}
| Month ([[wikipedia:genitive|genitive form]])
|-
| <code><nowiki>{{CURRENTMONTHABBREV}}</nowiki></code>
| {{CURRENTMONTHABBREV}}
| Month (abbreviation)
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Day'''
|-
| <code><nowiki>{{CURRENTDAY}}</nowiki></code>
| {{CURRENTDAY}}
| Day of the month (unpadded number)
|-
| <code><nowiki>{{CURRENTDAY2}}</nowiki></code>
| {{CURRENTDAY2}}
| Day of the month (zero-padded number)
|-
| <code><nowiki>{{CURRENTDOW}}</nowiki></code>
| {{CURRENTDOW}}
| Day of the week (unpadded number)
|-
| <code><nowiki>{{CURRENTDAYNAME}}</nowiki></code>
| {{CURRENTDAYNAME}}
| Day of the week (name)
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Time'''
|-
| <code><nowiki>{{CURRENTTIME}}</nowiki></code>
| {{CURRENTTIME}}
| Time (24-hour HH:mm format)
|-
| <code><nowiki>{{CURRENTHOUR}}</nowiki></code>
| {{CURRENTHOUR}}
| Hour (24-hour zero-padded number)
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Other'''
|-
| <code><nowiki>{{CURRENTWEEK}}</nowiki></code>
| {{CURRENTWEEK}}
| Week (number)
|-
| <code><nowiki>{{CURRENTTIMESTAMP}}</nowiki></code>
| {{CURRENTTIMESTAMP}}
| YYYYMMDDHHmmss timestamp
|}

The following variables do the same as the above, but using the site's server config or $wgLocaltimezone.
* <code><nowiki>{{LOCALYEAR}}</nowiki></code>
* <code><nowiki>{{LOCALMONTH}}</nowiki></code>
* <code><nowiki>{{LOCALMONTHNAME}}</nowiki></code>
* <code><nowiki>{{LOCALMONTHNAMEGEN}}</nowiki></code>
* <code><nowiki>{{LOCALMONTHABBREV}}</nowiki></code>
* <code><nowiki>{{LOCALDAY}}</nowiki></code>
* <code><nowiki>{{LOCALDAY2}}</nowiki></code>
* <code><nowiki>{{LOCALDOW}}</nowiki></code>
* <code><nowiki>{{LOCALDAYNAME}}</nowiki></code>
* <code><nowiki>{{LOCALTIME}}</nowiki></code>
* <code><nowiki>{{LOCALHOUR}}</nowiki></code>
* <code><nowiki>{{LOCALWEEK}}</nowiki></code>
* <code><nowiki>{{LOCALTIMESTAMP}}</nowiki></code>

:''For more thorough time formatting, you may want to use the [[mw:Help:Extension:ParserFunctions#.23time|#time parser function]].''

=== Technical metadata ===
''Note:'' Revision variables return data about the '''latest edit to the current page''', even if viewing an older version of the page.
{| class="wikitable"
|-
! style="background:#A7C1F2" | Variable
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Site'''
|-
| <code><nowiki>{{SITENAME}}</nowiki></code>
| {{SITENAME}}
| The wiki's site name ([[mw:Manual:$wgSitename|$wgSitename]]).
|-
| <code><nowiki>{{SERVER}}</nowiki></code>
| {{SERVER}}
| domain URL ([[mw:Manual:$wgServer|$wgServer]])
|-
| <code><nowiki>{{SERVERNAME}}</nowiki></code>
| {{SERVERNAME}}
| domain name
|-
| <code><nowiki>{{DIRMARK}}</nowiki></code> <code><nowiki>{{DIRECTIONMARK}}</nowiki></code>
| {{DIRMARK}} {{DIRECTIONMARK}}
| Outputs a unicode-directional mark that matches the wiki's default language's direction (<code>&lrm;</code> on left-to-right wikis, <code>&rlm;</code> on right-to-left wikis), useful in text with multi-directional text.
|-
| <code><nowiki>{{SCRIPTPATH}}</nowiki></code>
| {{SCRIPTPATH}}
| relative script path ([[mw:Manual:$wgScriptPath|$wgScriptPath]])
|-
| <code><nowiki>{{STYLEPATH}}</nowiki></code>
| {{STYLEPATH}}
| relative style path ([[mw:Manual:$wgStylePath|$wgStylePath]])
|-
| <code><nowiki>{{CURRENTVERSION}}</nowiki></code>
| {{CURRENTVERSION}}
| The wiki's MediaWiki version.
|-
| <code><nowiki>{{CONTENTLANGUAGE}}</nowiki></code> <code><nowiki>{{CONTENTLANG}}</nowiki></code>
| {{CONTENTLANGUAGE}} {{CONTENTLANG}}
| The wiki's default interface language ([[mw:Manual:$wgLanguageCode|$wgLanguageCode]])
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Latest revision to current page'''
|-
| <code><nowiki>{{REVISIONID}}</nowiki></code>
| {{REVISIONID}}
| Unique revision ID
|-
| <code><nowiki>{{REVISIONDAY}}</nowiki></code>
| {{REVISIONDAY}}
| Day edit was made (unpadded number)
|-
| <code><nowiki>{{REVISIONDAY2}}</nowiki></code>
| {{REVISIONDAY2}}
| Day edit was made (zero-padded number)
|-
| <code><nowiki>{{REVISIONMONTH}}</nowiki></code>
| {{REVISIONMONTH}}
| Month edit was made (zero-padded number)
|-
| <code><nowiki>{{REVISIONMONTH1}}</nowiki></code>
| {{REVISIONMONTH1}}
| Month edit was made (unpadded number)
|-
| <code><nowiki>{{REVISIONYEAR}}</nowiki></code>
| {{REVISIONYEAR}}
| Year edit was made
|-
| <code><nowiki>{{REVISIONTIMESTAMP}}</nowiki></code>
| {{REVISIONTIMESTAMP}}
| Timestamp as of time of edit
|-
| <code><nowiki>{{REVISIONUSER}}</nowiki></code>
| {{REVISIONUSER}}
| The username of the user who made the most recent edit to the page, or the current user when previewing an edit
|-style="background:#FED;"
| <code><nowiki>{{PAGESIZE:</nowiki>''page name''<nowiki>}}</nowiki></code> <code><nowiki>{{PAGESIZE:</nowiki>''page name''<nowiki>|R}}</nowiki>
| {{PAGESIZE:Help:Magic words}} {{PAGESIZE:Help:Magic words|R}}
| '''[expensive]''' Returns the byte size of the specified page. Use "<code><nowiki>|R</nowiki></code>" to get raw numbers.
|-
| <code><nowiki>{{PROTECTIONLEVEL:</nowiki>''action''<nowiki>}}</nowiki></code>
| protection level
| Outputs the protection level (e.g. 'autoconfirmed', 'sysop') for a given action (e.g. 'edit', 'move') on the current page or an empty string if not protected.
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Affects page content'''
|-
| <code><nowiki>{{DISPLAYTITLE:</nowiki>''title''<nowiki>}}</nowiki></code>
|
| Format the current page's title header. The value must be equivalent to the default title: only capitalization changes and replacing spaces with underscores are allowed.
|-
| <code><nowiki>{{DEFAULTSORT:</nowiki>''sortkey''<nowiki>}}</nowiki></code> <code><nowiki>{{DEFAULTSORTKEY:</nowiki>''sortkey''<nowiki>}}</nowiki></code> <code><nowiki>{{DEFAULTCATEGORYSORT:</nowiki>''sortkey''<nowiki>}}</nowiki></code>
|
| Used for categorizing pages, sets a default [[Help:Categories|category sort key]]. For example if you put <code><nowiki>{{DEFAULTSORT:Update, BIOS}}</nowiki></code> at the end of [[BIOS Update]], the page would be sorted under "U" by default in categories.
|}

=== Statistics ===
Numbers returned by these variables normally contain separators (commas or spaces, depending on the local language), but can return raw numbers with the ":R" flag (for example, <code><nowiki>{{NUMBEROFPAGES}}</nowiki></code> → {{NUMBEROFPAGES}} and <code><nowiki>{{NUMBEROFPAGES:R}}</nowiki></code> → {{NUMBEROFPAGES:R}}). Use "|R" for magic words that require a parameter like PAGESINCATEGORY (for example <code><nowiki>{{PAGESINCATEGORY:Help}}</nowiki></code> and <code><nowiki>{{PAGESINCATEGORY:Help|R}}</nowiki></code>). Also applicable to <code><nowiki>{{PAGESIZE:</nowiki>''page name''<nowiki>}}</nowiki></code> above.

The number magic words are formatted in the english language.

{| class="wikitable"
|-
! style="background:#A7C1F2" | Variable
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
! style="background:#8DA7D6; color:black;" colspan="4"| '''Entire wiki'''
|-
| <code><nowiki>{{NUMBEROFPAGES}}</nowiki></code>
| {{NUMBEROFPAGES}}
| Number of wiki pages.
|-
| <code><nowiki>{{NUMBEROFARTICLES}}</nowiki></code>
| {{NUMBEROFARTICLES}}
| Number of pages in [[mw:Manual:Using custom namespaces#Content namespaces|content namespaces]].
|-
| <code><nowiki>{{NUMBEROFFILES}}</nowiki></code>
| {{NUMBEROFFILES}}
| Number of uploaded files.
|-
| <code><nowiki>{{NUMBEROFEDITS}}</nowiki></code>
| {{NUMBEROFEDITS}}
| Number of page edits.
|-
| <code><nowiki>{{NUMBEROFVIEWS}}</nowiki></code>
| {{NUMBEROFVIEWS}}
| Number of page views. Usually useless on a wiki using [[mw:Manual:Cache|caching]].
|-
| <code><nowiki>{{NUMBEROFUSERS}}</nowiki></code>
| {{NUMBEROFUSERS}}
| Number of registered users.
|-
| <code><nowiki>{{NUMBEROFADMINS}}</nowiki></code>
| {{NUMBEROFADMINS}}
| Number of users in the ''sysop'' [[mw:Manual:User rights|group]].
|-
| <code><nowiki>{{NUMBEROFACTIVEUSERS}}</nowiki></code>
| {{NUMBEROFACTIVEUSERS}}
| Number of active users, based on the criteria used in [[Special:Statistics]].
|- style="background:#FED;"
| <code><nowiki>{{PAGESINCATEGORY:</nowiki>''categoryname''<nowiki>}}</nowiki></code> <code><nowiki>{{PAGESINCAT:Help}}</nowiki></code>
| {{PAGESINCATEGORY:Help}} {{PAGESINCAT:Help}}
| '''[expensive]''' Number of pages in the given [[Help:Categories|category]].
|-
| <code><nowiki>{{NUMBERINGROUP:</nowiki>''groupname''<nowiki>}}</nowiki></code> <code><nowiki>{{NUMINGROUP:</nowiki>''groupname''<nowiki>}}</nowiki></code>
| {{NUMBERINGROUP:bureaucrat}} {{NUMINGROUP:bureaucrat}} <nowiki>({{NUMBERINGROUP:bureaucrat}} used here)</nowiki>
| Number of users in a specific [[mw:Manual:User rights|group]].
|}

=== Page names ===
{| class="wikitable"
|-
! style="background:#A7C1F2" | Variable
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
| <code><nowiki>{{FULLPAGENAME}}</nowiki></code>
| {{FULLPAGENAME}}
| Namespace and page title.
|-
| <code><nowiki>{{PAGENAME}}</nowiki></code>
| {{PAGENAME}}
| Page title.
|-
| <code><nowiki>{{BASEPAGENAME}}</nowiki></code>
| {{BASEPAGENAME}}
| Page title excluding the current [[Help:Subpages|subpage]] and namespace ("Title/foo" on "Title/foo/bar").
For more complex splitting, use <code><nowiki>{{</nowiki>[[mw:Help:Extension:ParserFunctions#.23titleparts|#titleparts:]]<nowiki>}}</nowiki></code> from [[mw:Help:Extension:ParserFunctions|ParserFunctions extension]].
|-
| <code><nowiki>{{SUBPAGENAME}}</nowiki></code>
| {{SUBPAGENAME}}
| The [[Help:Subpages|subpage]] title ("foo" on "Title/foo").
|-
| <code><nowiki>{{SUBJECTPAGENAME}}</nowiki></code>
| {{SUBJECTPAGENAME}}
| The namespace and title of the associated subject page.
|-
| <code><nowiki>{{TALKPAGENAME}}</nowiki></code>
| {{TALKPAGENAME}}
| The namespace and title of the associated talk page.
|}

The <code><nowiki>{{BASEPAGENAME}}</nowiki></code> and <code><nowiki>{{SUBPAGENAME}}</nowiki></code> magic words only work in namespaces that have subpages enabled.

The following are equivalents encoded for use in MediaWiki URLs (i.e. spaces replaced with underscores and some characters [[wikipedia:percent-encoding|percent-encoded]]):
* <code><nowiki>{{FULLPAGENAMEE}}</nowiki></code>
* <code><nowiki>{{PAGENAMEE}}</nowiki></code>
* <code><nowiki>{{BASEPAGENAMEE}}</nowiki></code>
* <code><nowiki>{{SUBPAGENAMEE}}</nowiki></code>
* <code><nowiki>{{SUBJECTPAGENAMEE}}</nowiki></code>
* <code><nowiki>{{TALKPAGENAMEE}}</nowiki></code>

These can all take a parameter, allowing specification of the page to be operated on, instead of just the current page:
* <code><nowiki>{{PAGENAME:Template:Main Page}}</nowiki></code> → '''{{PAGENAME:Template:Main Page}}'''

{{Warning|Page titles containing certain characters, such as single quotes (<code>'</code>) or asterisks (<code>*</code>), may produce unexpected results when handled with these magic words, e.g. <code><nowiki>{{PAGESINCATEGORY:{{PAGENAME}}}}</nowiki></code>. See bugs [[mediazilla:14779|14779]], [[mediazilla:16474|16474]].}}

Note that <code><nowiki>{{PAGENAME}}</nowiki></code>, <code><nowiki>{{PAGENAMEE}}</nowiki></code> and <code><nowiki>{{urlencode:}}</nowiki></code> have distinct implementations. See [[mw:Manual:PAGENAMEE encoding|Manual:PAGENAMEE encoding]] for details.

=== Namespaces ===
{| class="wikitable"
|-
! style="background:#A7C1F2" | Variable
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
| <code><nowiki>{{NAMESPACE}}</nowiki></code>
| {{NAMESPACE}}
| Name of the page's namespace
|-
| <code><nowiki>{{SUBJECTSPACE}}</nowiki></code> <code><nowiki>{{ARTICLESPACE}}</nowiki></code>
| {{SUBJECTSPACE}} {{ARTICLESPACE}}
| Name of the associated content namespace
|-
| <code><nowiki>{{TALKSPACE}}</nowiki></code>
| {{TALKSPACE}}
| Name of the associated talk namespace
|}

The following are equivalents encoded for use in MediaWiki URLs (spaces replaced with underscores and some characters percent-encoded):
* <code><nowiki>{{NAMESPACEE}}</nowiki></code>
* <code><nowiki>{{SUBJECTSPACEE}}</nowiki></code>
* <code><nowiki>{{TALKSPACEE}}</nowiki></code>

These can take a full-page-name parameter and will return the requested namespace associated with that page, instead of with the current page:
* <code><nowiki>{{NAMESPACE:Template:Main Page}}</nowiki></code> → '''{{NAMESPACE:Template:Main Page}}'''
* <code><nowiki>{{SUBJECTSPACE:Template:Main Page}}</nowiki></code> → '''{{SUBJECTSPACE:Template:Main Page}}'''
* <code><nowiki>{{TALKSPACE:Template:Main Page}}</nowiki></code> → '''{{TALKSPACE:Template:Main Page}}'''
Parameter must not be a namespace name:
* <code><nowiki>{{SUBJECTSPACE:Help talk}}</nowiki></code> → '''{{SUBJECTSPACE:Help talk}}'''

== Parser functions ==

Parser functions are very similar to variables, but take one or more parameters (technically, any magic word that takes a parameter is a parser function), and the name is sometimes prefixed with a hash to distinguish them from templates.

This page only describes parser functions that are integral to the MediaWiki software. Other parser functions are added by the ParserFunctions extension. For those see [[mw:Help:Extension:ParserFunctions|Help:Extension:ParserFunctions]].

=== URL data ===
{| class="wikitable"
|-
! style="background:#A7C1F2" | Parser function
! style="background:#A7C1F2" | Input → Output
! style="background:#A7C1F2" | Description
|-
| <code><nowiki>{{localurl:</nowiki>''page name''<nowiki>}}</nowiki></code> <code><nowiki>{{localurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{localurl:MediaWiki}}</nowiki></code> → {{localurl:MediaWiki}} <nowiki>{{localurl:MediaWiki|printable=yes}}</nowiki> → {{localurl:MediaWiki|printable=yes}}
| The relative path to the title.
|-
| <code><nowiki>{{fullurl:</nowiki>''page name''<nowiki>}}</nowiki></code> <code><nowiki>{{fullurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></code> <code><nowiki>{{fullurl:</nowiki>''interwiki:remote page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{fullurl:Category:Top level}}</nowiki></code> → {{fullurl:Category:Top level}} 
<code><nowiki>{{fullurl:Category:Top level|action=edit}}</nowiki></code> → {{fullurl:Category:Top level|action=edit}}
| The absolute path to the title. This will also resolve [[mw:Manual:Interwiki|Interwiki]] prefixes.
|-
| <code><nowiki>{{filepath:</nowiki>''file name''<nowiki>}}</nowiki></code> <code><nowiki>{{filepath:</nowiki>''file name''<nowiki>|nowiki}}</nowiki></code>
| <code><nowiki>{{filepath:Wiki.png}}</nowiki></code> → {{filepath:Wiki.png}} 
<code><nowiki>{{filepath:Wiki.png|nowiki}}</nowiki></code> → {{filepath:Wiki.png|nowiki}} 
<code><nowiki>{{filepath:Example.svg|300}}</nowiki></code> → {{filepath:Example.svg|300}} 
| The absolute URL to the full size of a media file.
|-
| <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>}}</nowiki></code> (or <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>|QUERY}}</nowiki></code>) <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>|WIKI}}</nowiki></code> <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>|PATH}}</nowiki></code>
| <code><nowiki>{{urlencode:x y z á é}}</nowiki></code> (or <code><nowiki>{{urlencode:x y z á é|QUERY}})</nowiki></code> → {{urlencode:x y z á é}} <code><nowiki>{{urlencode:x y z á é|WIKI}}</nowiki></code> → x_y_z_%C3%A1_%C3%A9 <code><nowiki>{{urlencode:x y z á é|PATH}}</nowiki></code> → x%20y%20z%20%C3%A1%20%C3%A9
Note that the default changed from <code>|WIKI</code> to <code>|QUERY</code> in 1.17; this may break templates that rely on this function.
| The input encoded for use in URLs. Note that there is no urldecode function like there is in the obsolete [[mw:Extension:StringFunctions|Extension:StringFunctions]].
|-
| <code><nowiki>{{anchorencode:</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{anchorencode:x y z á é}}</nowiki></code> → {{anchorencode:x y z á é}}
| The input encoded for use in URL section anchors (after the '#' symbol in a URL).
|}

=== Namespaces ===
<code><nowiki>{{ns:}}</nowiki></code> returns the current localized name for the [[Help:Namespaces|namespace]] with that index, canonical name, or local alias. Thus <code><nowiki>{{ns:6}}</nowiki></code>, <code><nowiki>{{ns:File}}</nowiki></code>, and <code><nowiki>{{ns:Image}}</nowiki></code> (an old name for the File namespace) all return "{{ns:6}}". On a wiki where the content language was French, <code><nowiki>{{ns:Fichier}}</nowiki></code> would also be valid, but <code><nowiki>{{ns:Datei}}</nowiki></code> (the localisation of "File" into German) would not.

<code><nowiki>{{nse:}}</nowiki></code> is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.
{| class="wikitable"
|-
! style="background:#8DA7D6; color:black;" colspan="2" width="50%" | Content namespaces
! rowspan="12" |
! style="background:#8DA7D6; color:black;" colspan="2" width=%50%" | Talk namespaces
|-
! style="background:#A7C1F2" | Usage
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Usage
! style="background:#A7C1F2" | Output
|-
| <code><nowiki>{{ns:-2}}</nowiki></code> or <code><nowiki>{{ns:Media}}</nowiki></code>
| {{ns:-2}} || ||
|-
| <code><nowiki>{{ns:-1}}</nowiki></code> or <code><nowiki>{{ns:Special}}</nowiki></code>
| {{ns:-1}} || ||
|-
| <code><nowiki>{{ns:0}}</nowiki></code> or <code><nowiki>{{ns:}}</nowiki></code>
| {{ns:}}
| <code><nowiki>{{ns:1}}</nowiki></code> or <code><nowiki>{{ns:Talk}}</nowiki></code>
| {{ns:1}}
|-
| <code><nowiki>{{ns:2}}</nowiki></code> or <code><nowiki>{{ns:User}}</nowiki></code>
| {{ns:2}}
| <code><nowiki>{{ns:3}}</nowiki></code> or <code><nowiki>{{ns:User talk}}</nowiki></code>
| {{ns:3}}
|-
| <code><nowiki>{{ns:4}}</nowiki></code> or <code><nowiki>{{ns:Project}}</nowiki></code>
| {{ns:4}}
| <code><nowiki>{{ns:5}}</nowiki></code> or <code><nowiki>{{ns:Project talk}}</nowiki></code>
| {{ns:5}}
|-
| <code><nowiki>{{ns:6}}</nowiki></code> or <code><nowiki>{{ns:File}}</nowiki></code> or <code><nowiki>{{ns:Image}}</nowiki></code>
| {{ns:6}}
| <code><nowiki>{{ns:7}}</nowiki></code> or <code><nowiki>{{ns:File talk}}</nowiki></code> or <code><nowiki>{{ns:Image talk}}</nowiki></code>
| {{ns:7}}
|-
| <code><nowiki>{{ns:8}}</nowiki></code> or <code><nowiki>{{ns:MediaWiki}}</nowiki></code>
| {{ns:8}}
| <code><nowiki>{{ns:9}}</nowiki></code> or <code><nowiki>{{ns:MediaWiki talk}}</nowiki></code>
| {{ns:9}}
|-
| <code><nowiki>{{ns:10}}</nowiki></code> or <code><nowiki>{{ns:Template}}</nowiki></code>
| {{ns:10}}
| <code><nowiki>{{ns:11}}</nowiki></code> or <code><nowiki>{{ns:Template talk}}</nowiki></code>
| {{ns:11}}
|-
| <code><nowiki>{{ns:12}}</nowiki></code> or <code><nowiki>{{ns:Help}}</nowiki></code>
| {{ns:12}}
| <code><nowiki>{{ns:13}}</nowiki></code> or <code><nowiki>{{ns:Help talk}}</nowiki></code>
| {{ns:13}}
|-
| <code><nowiki>{{ns:14}}</nowiki></code> or <code><nowiki>{{ns:Category}}</nowiki></code>
| {{ns:14}}
| <code><nowiki>{{ns:15}}</nowiki></code> or <code><nowiki>{{ns:Category talk}}</nowiki></code>
| {{ns:15}}
|}

=== Formatting ===
{| class="wikitable"
! style="background:#A7C1F2" | Usage
! style="background:#A7C1F2" | Input → Output
! style="background:#A7C1F2" | Description
|-
|-
| <code><nowiki>{{lc:</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{lc:DATA CENTER}}</nowiki></code> → {{lc:DATA CENTER}}
| The lowercase input.
|-
| <code><nowiki>{{lcfirst:</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{lcfirst:DATA center}}</nowiki></code> → {{lcfirst:DATA center}}
| The input with the very first character lowercase.
|-
| <code><nowiki>{{uc:</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{uc:text transform}}</nowiki></code> → {{uc:text transform}}
| The uppercase input.
|-
| <code><nowiki>{{ucfirst:</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{ucfirst:text TRANSFORM}}</nowiki></code> → {{ucfirst:text TRANSFORM}}
| The input with the very first character uppercase.
|-
| <code><nowiki>{{formatnum:</nowiki>''unformatted num''<nowiki>}}</nowiki></code> <code><nowiki>{{formatnum:</nowiki>''formatted num''<nowiki>|R}}</nowiki></code>
| <code><nowiki>{{formatnum:987654321.654321}}</nowiki></code> → {{formatnum:987654321.654321}} <code><nowiki>{{formatnum:987,654,321.654321|R}}</nowiki></code> → {{formatnum:987,654,321.654321|R}} <code><nowiki>{{formatnum:00001}}</nowiki></code> → {{formatnum:00001}}
| The input with decimal and decimal group separators, and localized digit script, according to the wiki's default locale. The <code><nowiki>|</nowiki>R</code> parameter can be used to unformat a number, for use in mathematical situations. {{Warning|Leading zeroes are not removed, you can use <nowiki>{{#expr:00001}}</nowiki> instead.}}
|-
|
<code><nowiki>{{#dateformat:</nowiki>''date''<nowiki>}}
{{#formatdate:</nowiki>''date''<nowiki>}}
{{#dateformat:</nowiki>''date''{{!}}''format''<nowiki>}}
{{#formatdate:</nowiki>''date''{{!}}''format''<nowiki>}}</nowiki></code>
|
<code><nowiki>{{#dateformat:25 deC 2009|ymd}}</nowiki></code> 
→ {{#dateformat:25 deC 2009|ymd}} (your pref), 2009 DeC 25 (default) 
<code><nowiki>{{#formatdate:dec 25,2009|dmy}}</nowiki></code> 
→ {{#formatdate:dec 25,2009|dmy}} (your pref), 25 Dec 2009 (default) 
<code><nowiki>{{#dateformat:2009-12-25|mdy}}</nowiki></code> 
→ {{#dateformat:2009-12-25|mdy}} (your pref), December 25, 2009 (default) 
<code><nowiki>{{#formatdate:2009 dec 25|ISO 8601}}</nowiki></code> 
→ {{#formatdate:2009 dec 25|ISO 8601}} (your pref), 2009-12-25 (default) 
<code><nowiki>{{#dateformat:25 decEmber|mdy}}</nowiki></code> 
→ {{#dateformat:25 decEmber|mdy}} (your pref), DecEmber 25 (default) 

Note: In the example above, "your pref" refers to your date preference on the current MediaWiki wiki only.
| Formats an unlinked date based on user "Date format" preference, and adds metadata tagging it as a formatted date. For logged-out users and those who have not set a date format in their preferences, dates can be given a default: <code>mdy</code>, <code>dmy</code>, <code>ymd</code>, <code>ISO 8601</code> (all case sensitive). If only the month and day are given, only <code>mdy</code> and <code>dmy</code> are valid. If a format is not specified or is invalid, the input format is used as a default. If the supplied date is not recognized as a valid date (specifically, if it contains any metadata such as from a nested use of these or similar templates), it is rendered unchanged, and no (additional) metadata is generated. {{warning}}Although the ISO 8601 standard requires that dates be in the Gregorian calendar, the ISO parameter in this function will still format dates that fall outside the usual Gregorian range (e.g. dates prior to 1583). Also, the magic word cannot properly convert between negative years (used with ISO 8601) and years BC or years BCE (used in general writing).
|-
| <code><nowiki>{{padleft:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></code> <code><nowiki>{{padleft:xyz|</nowiki>''strlen''<nowiki>|</nowiki>''char''<nowiki>}}</nowiki></code> <code><nowiki>{{padleft:xyz|</nowiki>''strlen''<nowiki>|</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{padleft:xyz|5}}</nowiki></code> → {{padleft:xyz|5}} <code><nowiki>{{padleft:xyz|5|_}}</nowiki></code> → {{padleft:xyz|5|_}} <code><nowiki>{{padleft:xyz|5|abc}}</nowiki></code> → {{padleft:xyz|5|abc}} <code><nowiki>{{padleft:xyz|2}}</nowiki></code> → {{padleft:xyz|2}} <code><nowiki>{{padleft:|1|xyz}}</nowiki></code> → {{padleft:|1|xyz}} (first character of the string) 
| Inserts a string of padding characters (character chosen in third parameter; default '0') of a specified length (second parameter) next to a chosen base character or variable (first parameter). The final digits or characters in the base replace the final characters in the padding; i.e. <code><nowiki>{{padleft:44|3|0}}</nowiki></code> produces {{padleft:44|3}}. The padding string may be truncated if its length does not evenly divide the required number of characters.
|-
| <code><nowiki>{{padright:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></code> <code><nowiki>{{padright:xyz|</nowiki>''strlen''<nowiki>|</nowiki>''char''<nowiki>}}</nowiki></code> <code><nowiki>{{padright:xyz|</nowiki>''strlen''<nowiki>|</nowiki>''string''<nowiki>}}</nowiki></code>
| <code><nowiki>{{padright:xyz|5}}</nowiki></code> → {{padright:xyz|5}} 
<code><nowiki>{{padright:xyz|5|_}}</nowiki></code> → {{padright:xyz|5|_}}
<code><nowiki>{{padright:xyz|5|abc}}</nowiki></code> → {{padright:xyz|5|abc}}
<code><nowiki>{{padright:xyz|2}}</nowiki></code> → {{padright:xyz|2}} 
<code><nowiki>{{padright:|1|xyz}}</nowiki></code> → {{padright:|1|xyz}} 
| Identical to padleft, but adds padding characters to the right side.
|-
| <code><nowiki>{{plural:2|</nowiki>''is''<nowiki>|</nowiki>''are''<nowiki>}}</nowiki></code>
| <code><nowiki>{{plural:0|is|are}}</nowiki></code> → {{plural:0|is|are}} <code><nowiki>{{plural:1*1|is|are}}</nowiki></code> → {{plural:1*1|is|are}} <code><nowiki>{{plural:21 mod 10|is|are}}</nowiki></code> → {{plural:21 mod 10|is|are}} <code><nowiki>{{plural:{{#expr:21 mod 10}}|is|are}}</nowiki></code> → {{plural:{{#expr:21 mod 10}}|is|are}} <code><nowiki>{{plural:1|is|are}}</nowiki></code> → {{plural:1|is|are}} <code><nowiki>{{plural:2|is|are}}</nowiki></code> → {{plural:2|is|are}} (for [[wikipedia:Polish_language|Polish]]): <code><nowiki>{{plural:2|milion|miliony|milionów}}</nowiki></code> → miliony
| Outputs the singular form (second parameter) if the first parameter is an expression equalling one; the plural form (third parameter) otherwise. Plural transformations are used for languages like Russian based on "count mod 10". You should not expect this to handle fractions (like 44.5) — see [[mediazilla:28128|bug 28128]].
|-
| <code><nowiki>{{grammar:N|</nowiki>''noun''<nowiki>}}</nowiki></code>
|
| Outputs the correct inflected form of the given word described by the inflection code after the colon (language-dependent). Grammar transformations are used for inflected languages like Polish. See also [[mw:Manual:$wgGrammarForms|Manual:$wgGrammarForms]].
|}

'''see also:''' [[mw:Extension:StringFunctions|Extension:StringFunctions]]

=== Miscellaneous ===
{| class="wikitable plainlinks"
! style="background:#A7C1F2" | Usage
! style="background:#A7C1F2" | Output
! style="background:#A7C1F2" | Description
|-
| <code><nowiki>{{int:</nowiki>''message name''<nowiki>}}</nowiki>
| <code><nowiki>{{int:</nowiki>edit<nowiki>}}</nowiki></code> → '''{{int:edit}}''' ''(depends on user language, try: [{{fullurl:{{FULLPAGENAME}}|uselang=fr}}#Miscellaneous fr] •[{{fullurl:{{FULLPAGENAME}}|uselang=ja}}#Miscellaneous ja])''
| Internationalizes (translates) the given '''int'''erface (MediaWiki namespace) message into the user language. ''Note that this can damage/confuse cache consistency, see [[mediazilla:14404|bug 14404]].''

|-
| <code><nowiki>{{#language:</nowiki>''language code''<nowiki>}}</nowiki></code> 
<code><nowiki>{{#language:ar}}</nowiki></code>
| {{#language:language code}} {{#language:ar}}
| The full name of the language for the given language code: native name by default. Codes are mostly in accordance with [[Wikipedia:ISO 639|ISO 639]].
|-
| <code><nowiki>{{#special:</nowiki>''special page name''<nowiki>}}</nowiki> <nowiki>{{#special:userlogin}}</nowiki></code>
| {{#special:special page name}} {{#special:userlogin}}
| The localized name for the given canonical Special: page.
|-
| <code><nowiki>{{#tag:</nowiki>''tagname'' <nowiki>|</nowiki>''content'' <nowiki>|</nowiki>''parameter1=value1'' <nowiki>|</nowiki>''parameter2=value2'' <nowiki>}}</nowiki></code>
| ''(depends on parser tag)''
| Alias for XML-style parser or extension tags, but parsing wiki code. Inner content can be passed as first parameter, and attributes as subsequent ones:

<code><</code>''tagname'' ''attribute1''="''value1''" ''attribute2''="''value2''"<code>></code> ''content'' <code></</code>''tagname'' <code>></code> → <code><nowiki>{{#tag:</nowiki></code>''tagname''<code><nowiki>|</nowiki></code>''content''<code><nowiki>|</nowiki></code>''attribute1''=''value1''<code><nowiki>|</nowiki></code>''attribute2''=''value2''<code><nowiki>}}</nowiki></code>

'''Warning''' : You must write <code><nowiki>{{#tag:</nowiki></code>''tagname''<code><nowiki>||</nowiki></code>''attribute1''=''value1''<code><nowiki>|</nowiki></code>''attribute2''=''value2''<code><nowiki>}}</nowiki></code> to pass an empty content.
No space is permitted between the {{!}} and the attribute name.
|-
| <code><nowiki>{{gender:</nowiki>''username'' <nowiki>|</nowiki>''return text if user is male'' <nowiki>|</nowiki>''return text if user is female'' <nowiki>|</nowiki>''return text if user hasn't defined their gender''<nowiki>}}</nowiki></code>
| ''(depends on the named user's gender)''
| A switch for the gender set in [[Special:Preferences]] 
Note: If 3rd parameter is omitted and user hasn't defined his/her gender, then <code>''text if user is male''</code> is returned.
|}

[[Category:Help]]

Справка:Templates/Thankyou

2011-12-24T15:12:36Z

Langator: Новая страница: «<div class="noprint" style="float:center; border:1px solid blue;width:200px;background-color:#F5F5F5;padding:3px;"> [[Image:Example.jpg|left|80px|Example sunflower i...»

<div class="noprint" style="float:center; border:1px solid blue;width:200px;background-color:#F5F5F5;padding:3px;">
[[Image:Example.jpg|left|80px|Example sunflower image]] '''A little thank you...''' for {{{reason|{{{1}}}}}}. hugs, {{{signature|{{{2}}}}}}
</div>

Справка:Templates

2011-12-24T15:11:48Z

Langator: Новая страница: «If you have standard texts you want to include on several pages, the MediaWiki template feature comes into play. == Creation == Templates are standard wiki pages wh...»

If you have standard texts you want to include on several pages, the MediaWiki template feature comes into play.

== Creation ==
Templates are standard wiki pages whose content is designed to be [[wikipedia:Transclusion|transcluded]] (embedded) inside other pages. Templates follow a convention that the name is prefixed with "<code>Template:</code>", assigning it to that namespace; besides this, you can [[Help:Starting a new page|create them like any other wiki page]].

The simplest use of templates is as follows. If you create a page called "Template:Welcome" with contents:

Hello! Welcome to the wiki.

you'll have created your first template! If you then insert the code:

<nowiki>{{Welcome}}</nowiki>

in any other page, when that page is viewed the text "Hello! Welcome to the wiki." will appear instead of <code><nowiki>{{Welcome}}</nowiki></code>. The template content is "transcluded" into the other page, i.e. it is integrated in the page.

You can then insert <code><nowiki>{{Welcome}}</nowiki></code> at any point of any page where you wish to welcome someone. Suppose it is used in 100 pages. If you then change the template contents to:

Hi there! Welcome to this wonderful wiki.

and revisit any of the 100 pages where the template was used, you'll see the new text instead of the original one. In this way, you have changed the content of 100 pages without editing them, because the template is transcluded into these pages.

This is the basic mechanism. There are several additional features of transclusion that enrich this mechanism and make templates very useful.

== Usage ==
Templates can be used in other pages in these ways:
* <code><nowiki>{{Name}}</nowiki></code>, described above, 'transcludes' (i.e. includes a copy of) the content of the template (stored in the page <nowiki>[[Template:Name]]</nowiki>) whenever the page containing the template transclusion is fetched and displayed; i.e. if the template is later changed, the displayed transcluding page will automatically change too
* <code><nowiki>{{subst:Name}}</nowiki></code> replaces that string with the contents of the template, in the source of the transcluding page, when you save that page; the copy of the template contents can then be edited normally (and separately from the original in the template page). ''Note'': don't use this if you are looking to continually propagate changes from the source template to the page(s) that references it.
* <code><nowiki>{{safesubst:Name}}</nowiki></code> allows for substitution that doesn't break transclusion, see [[wikipedia:Help:Substitution#The_safesubst:_modifier|Help:Substitution]] on en.wikipedia.org.
* <code><nowiki>{{msgnw:Name}}</nowiki></code> includes the template in a form that displays it as raw wiki syntax (the way <code><nowiki><nowiki></nowiki></code> does) when the page containing it is fetched.

In fact, an ordinary wiki page can also be used as a template, simply by specifying the namespace it resides in, so:
* <code><nowiki>{{Template:Pagename}}</nowiki></code> includes <code><nowiki>[[Template:Pagename]]</nowiki></code>
* <code><nowiki>{{Foo:Pagename}}</nowiki></code> includes <code><nowiki>[[Foo:Pagename]]</nowiki></code>
* <code><nowiki>{{:Pagename}}</nowiki></code> includes <code><nowiki>[[Pagename]]</nowiki></code>
** <code><nowiki>{{subst::Pagename}}</nowiki></code> replaces itself with the contents of <code><nowiki>[[Pagename]]</nowiki></code>

If no such namespace exists, the full title is assumed to be a template:
* <code><nowiki>{{Foo:Bar}}</nowiki></code> includes <code><nowiki>[[Template:Foo:Bar]]</nowiki></code>

== Parameters ==
To enrich the mechanism of transclusion, MediaWiki allows parameters to be passed to a template when it is transcluded. Parameters allow the template to produce different contents or have different behaviors.

Suppose you wish to insert a little thank you note in the [[Help:Talk pages|talk page]] of other users, such as:
{{Help:Templates/Thankyou|all your effort|Me}}
The thank you note will have a reason (in this case, "all your effort") and a signature ("Me"). Your objective is that any user is able to thank any other user, for any reason whatsoever.

So that the note will look similar everywhere it is used, you can define a template called [[Help:Templates/Thankyou|Template:Thankyou]], for example. Although the note should look similar whenever a user thanks another user, its specific contents (i.e. the reason and the signature) will be different. For that reason, you should pass them as parameters. If we ignore the remaining elements to format the box and place the image, the core content of the template will be this:

<pre><nowiki>'''A little thank you...'''
for {{{1}}}.
hugs, {{{2}}}</nowiki></pre>

Notice the use of <code><nowiki>{{{1}}}</nowiki></code> and <code><nowiki>{{{2}}}</nowiki></code>. This is the way to identify, within templates, the parameters that will be passed in when the template is used. Note that, within the template, each parameter is surrounded by '''three''' braces: <code><nowiki>{{{ }}}</nowiki></code>. This is different from normal template name usage.

When using the template on a page, you fill in the parameter values, separated by a pipe char (<code>|</code>). MediaWiki allows parameters to be passed to the template in three ways.

=== Anonymous parameters ===
To pass in anonymous parameters, list the values of those parameters sequentially:
<nowiki>{{Thankyou|all your effort|Me}}</nowiki>
In this case, template <code><nowiki>{{Thankyou}}</nowiki></code> receives parameters <code><nowiki>{{{1}}}=all your effort</nowiki></code> and <code><nowiki>{{{2}}}=Me</nowiki></code> and produces:

{{Help:Templates/Thankyou|all your effort|Me}}

Inverting the order of the parameters:

<nowiki>{{Thankyou|Me|all your effort}}</nowiki>

causes template <code><nowiki>{{Thankyou}}</nowiki></code> to receive parameters <code><nowiki>{{{1}}}=Me</nowiki></code> and <code><nowiki>{{{2}}}=all your effort</nowiki></code> and inverts the result:

{{Help:Templates/Thankyou|Me|all your effort}}
So, the order in which anonymous parameters are passed in is crucial to its behaviour.

=== Numbered parameters ===
To pass in parameters by number, identify each parameter when passing it:

<nowiki>{{Thankyou|2=Me|1=your friendship}}</nowiki>

This time, template <code><nowiki>{{Thankyou}}</nowiki></code> receives parameters <code><nowiki>{{{1}}}=your friendship</nowiki></code> and <code><nowiki>{{{2}}}=Me</nowiki></code>, though they have been supplied in inverse order, and produces:
{{Help:Templates/Thankyou|2=Me|1=your friendship}}

=== Named parameters ===
The third way of passing parameters is by name, instead of numbers. In this case, the template contents would be changed to:

<pre><nowiki>'''A little thank you...'''
for {{{reason}}}.
hugs, {{{signature}}}</nowiki></pre>

Within the template, we use <code><nowiki>{{{reason}}}</nowiki></code> and <code><nowiki>{{{signature}}}</nowiki></code> to identify each parameter, instead of a number. To pass these parameters by name, identify each parameter when passing it:

<nowiki>{{Thankyou|signature=Me|reason=being who you are}}</nowiki>

In this case, template <code><nowiki>{{Thankyou}}</nowiki></code> receives parameters <code><nowiki>{{{reason}}}=being who you are</nowiki></code> and <code><nowiki>{{{signature}}}=Me</nowiki></code> and produces:

{{Help:Templates/Thankyou|signature=Me|reason=being who you are}}
The advantage of using named parameters in your template, besides also being flexible in the order parameters can be passed, is that it makes the template code much easier to understand if there are many parameters.

=== Default values ===
If you transclude a template that expects parameters, but do not provide them, in this way:

<nowiki>{{Thankyou}}</nowiki>

in the numbered parameters example above you would get the following:

{{Help:Templates/Thankyou}}
Since no parameters were passed in, the template presents the parameters themselves, instead of their respective values. In these cases, it may be useful to define ''default'' values for the parameters, i.e. values that will be used if no value is passed in. For example, if the template contents are changed to:

<pre><nowiki>'''A little thank you...'''
for {{{reason|everything}}}.
hugs, {{{signature|Me}}}</nowiki></pre>

then <code><nowiki>{{{reason|everything}}}</nowiki></code> defines that if no parameter <code>{{{reason}}}</code> is provided, then the value <code>everything</code> will be used. Similarly, <code><nowiki>{{{signature|Me}}}</nowiki></code>, defaults parameter <code>{{{signature}}}</code> to value <code>Me</code>. Now, transcluding the template again without passing any parameter, results in the following:

{{Help:Templates/Thankyou|reason=everything|signature=Me}}

=== Control template inclusion ===
By default, the whole content of a template will be processed and displayed both when the template page is being viewed directly and when the template is being included in another page. However, you can control template inclusion by the use of <code><nowiki><noinclude></nowiki></code> and
<code><nowiki><includeonly></nowiki></code> tags.

Anything between <code><nowiki><noinclude></nowiki></code> and <code><nowiki></noinclude></nowiki></code> will be processed and displayed only when the template's page is being viewed directly, and will not be processed and displayed when it is included in another page. The application of this is to do things to the template page that should not be similarly done to the pages where it is included:

* [[Help:Categories|Categorising]] the template.
* Placing in the template [[Help:Links#Interlanguage links|interlanguage links]] to similar templates in other languages.
* Presenting explanatory text about how to use the template.

Anything between <code><nowiki><includeonly></nowiki></code> and <code><nowiki></includeonly></nowiki></code> will be processed and displayed only when the page is being included, and will not be processed and displayed when the template page is being viewed directly. The application of this is to do things in the pages where the template is included that you do not want to be similarly done in the template page:
* [[Help:Categories|Categorising]] only the pages where the template is included. Note that when you change the categories applied by a template in this fashion, the categorization of all the pages where that template is included may not be updated until some time later: this is handled by the [[mw:Manual:Job queue|job queue]]. To force the re-categorisation of a particular page, open the page for edit and save it without changes.
* Ensuring that the template's code is not executed when viewing the template page itself. Normally this is because it isn't receiving any parameters and its execution without parameters has an undesired aspect.

Of course, everything outside <code><nowiki><noinclude></nowiki></code> and
<code><nowiki><includeonly></nowiki></code> tags is processed and displayed both when the template page is being viewed directly and when the template is being included in another page.

=== Organizing templates ===
For templates to be effective, users need to find them, and find out how to use them.

To find them, users can:
# Click '''Special Pages > All Pages'''
# In the '''Namespace''' list, choose '''Template''' and click '''Go'''.

To give usage information, include the [[Template:Documentation|<nowiki>{{Documentation}}</nowiki>]] template:

<pre><nowiki>
<noinclude>
{{Documentation}}
</noinclude>
</nowiki></pre>

Then save and click on the new '''doc''' link to create a documentation page to describe the usage of the template. An editor can simply copy and paste an usage example to use the template.

== Copying from one wiki to another ==
Templates often require [http://meta.wikimedia.org/wiki/Help:CSS CSS] or other templates, so users frequently have trouble copying templates from one wiki to another. The steps below should work for most templates.

=== MediaWiki code ===
If you have import rights on the new wiki:
# Go to [[Special:Export]] on the original wiki, and download an .xml file with the complete history of all necessary templates, as follows:
#* Enter the name of the template in the big text box.
#* Check the box "Include templates".
#* '''Uncheck''' the box "Include only the current revision".
#* Click Export.
# Go to [[Special:Import]] on the new wiki and upload the .xml file.

If you don't have import rights on the new wiki:
# Go to [[Special:Export]] on the original wiki, and download an .xml file with the latest version only of all necessary templates, as follows:
#* Enter the name of the template in the big text box.
#* Check the box "Include templates".
#* '''Check''' the box "Include only the current revision".
#* Click Export.
# Open the file in a text editor and manually copy the text inside the <code><nowiki><text></nowiki></code> tag of each listed template into a similarly named template in your wiki. In the edit summary of each template, link to the original page for attribution.

This will copy the entire code necessary, and will suffice for some templates.

=== Extensions ===
Check if the template depends on any extension. You have to convice sysops first to install the extension.

=== CSS and JavaScript code ===
Besides MediaWiki code, many templates make use of CSS and some rely on JavaScript to work fully. If the copied templates are not behaving as expected, this may be the cause. To copy the required CSS and JavaScript to your wiki you'll normally need to have admin priviledges, because you'll be editing system messages in the "MediaWiki:" namespace.

# Look for the use of CSS classes (text like <code>class="foobar"</code>) in the template text. If those classes appear in "MediaWiki:Common.css" or "MediaWiki:Monobook.css" on the original wiki, copy them to "MediaWiki:Common.css" on the new wiki and check if the template is now fine.
# If the copied template is still not working as expected, check if there is code in "MediaWiki:Common.js" or "MediaWiki:Monobook.js" on the original wiki. If so, you can try copying it to "MediaWiki:Common.js" on the new wiki. Normally, it is a good idea to only copy code from trusted sources, and first browsing the code to identify and select the parts that seem relevant. You may find comments that can serve as clues to identify the functionality of each part. When in doubt, copy all the code to the new wiki.

== Specifying parameter defaults ==
Very often you will see parameters in this form:
<pre>
{{{A template parameter|}}}
</pre>

The pipe character "|" is the delimiter for a default value in the parameter. In the example above, it is empty, so the default would be an empty string if no value were passed from the template to the parameter. Of course, you may define a default like this:

<pre>
{{{A template parameter|with a default value}}}
</pre>

The string "with a default value" is the default value of the parameter if it is not set elsewhere.

== See also ==
* [[Help:External searches]] – a template special use case example
* [[Help:Magic words]] – fancy stuff you may find in some templates
* [[mw:Help:Parser functions in templates|Help:Parser functions in templates]] on mediawiki.org
* [[metawikipedia:Help:Template|Help:Template]] on meta.wikimedia.org – contains a much more thorough manual on how exactly templates function
* [[metawikipedia:Help:Embed page|Help:Embed page]] on meta.wikimedia.org – embedding pages from [[Help:namespaces|namespaces]] other than <code>Template:</code>.

[[Category:Help]]

Справка:Patrolled edits

2011-12-24T15:11:10Z

Langator: Новая страница: «'''Patrolled edits''' are a feature which allows specific users to mark items in recent changes as having been "patrolled" or "approved". By default this is only ava...»

'''Patrolled edits''' are a feature which allows specific users to mark items in recent changes as having been "patrolled" or "approved". By default this is only available if you have sysop permissions.

This feature is useful when reviewing recent changes for undesirable edits, link spam and vandalism. This allows people (with permission to do so) to coordinate their patrolling activity, such that edits get checked over once, with less wasted effort (different people checking the same edit).

== Marking edits as patrolled ==
; To mark an edit as patrolled:
# Access [[Special:RecentChanges]]
#: Changes which are not patrolled will be indicated with a red exclamation mark
# Click the ([[metawikipedia:Help:Diff|diff]]) link next to an edit
# To mark the edit as patrolled, click the ''mark as patrolled'' link

== Hiding patrolled edits from recent changes ==
Patrolled edits can be hidden from recent changes by adding <tt>&hidepatrolled=1</tt> to the URL in the following form:

{{fullurl:{{#special:RecentChanges}}|hidepatrolled=1}}

== See also ==
* [[mw:Help:Patrolling|General definition of RC Patrolling]] on mediawiki.org
* [[metawikipedia:Help:Patrolled edit|Help:Patrolled edit]] on meta.wikimedia.org

[[Category:Help]]

Справка:Protected pages

2011-12-24T15:10:28Z

Langator: Новая страница: «A '''protected page''' is a page where normal users are prevented from editing and/or moving at all. Only a user with s...»

A '''protected page''' is a page where normal users are prevented from [[Help:Editing pages|editing]] and/or [[Help:Moving a page|moving]] at all. Only a user with sysop permissions can edit or move a protected page. Likewise only sysop users can protect a page in the first place, or unprotect the page to lift the restriction.

There are several reasons why a particular page might be protected:
* On public wikis, pages may be protected because they have been repeatedly targeted with vandalism or moved to bad titles, or where it is believed that vandalism or page moves would have a unusually severe impact.
* On corporate wikis, pages may be protected when they contain statements which have been approved by management, and policy dictates that those statements can't be changed without following a certain approval process.

Page protection limits collaboration on the wiki content, and should be avoided where possible.

[[Category:Help]]

Справка:Deleting a page

2011-12-24T15:09:57Z

Langator: Новая страница: «== When not to delete a page == Typically you would delete a page if the contents are entirely inappropriate and do not match the purposes of the Wiki. In other situ...»

== When not to delete a page ==
Typically you would delete a page if the contents are entirely inappropriate and do not match the purposes of the Wiki. In other situations, you would take a less extreme course of action, for example:

* The page should have a different title -- See [[Help:Moving a page]]
* The contents should have been placed on a different page -- Add the contents to the other page, and then supply a redirect. See [[Help:Redirects]]
* The contents are already on a different page -- Delete the duplicate content and leave a redirect. That way, the page title, which made sense to somebody, will helpfully redirect to the information. See [[Help:Redirects]]
* The page is out-of-date -- Re-word sentences to be in the past tense, to make the page an historical record. Alternatively, label the information as out-of-date, with a warning notice.

An actual delete is generally necessary only if the ''title'' of the page is inappropriate. In other situations, a merge and redirect is more appropriate.

=== Proposing changes ===
Deciding on appropriate content/page titles can be a difficult aspect of Wiki organization, and one which can often provoke debates. If the merge or deletion you have in mind is one which might cause upset, you should propose the change first. Do this by leaving a note to give your reasons on the [[Help:Talk pages|talk page]]. You might also establish a system for labeling the page with a delete/merge proposal template, to make everybody aware of your intentions.

=== Unlinking a page ===
The 'What links here' toolbox feature (bottom of left sidebar) will tell you which other Wiki pages link to the current page. Always use this feature to check before proceeding with deleting. These related pages will need to be edited for their links to reflect the change.

== Deletion itself ==
'''Normal users cannot permanently delete a Wiki page'''. This is a deliberate design feature, and is an important part of why wikis work. Every kind of editing operation can be reverted by any other user, and that includes resurrecting deleted content. It doesn't cause significant wasted space; and with nothing but a 'delete' label, the page is effectively deleted anyway.

'Sysop' users ''are'' able to delete a page semi-permanently. Typically 'sysops' might look for delete labels, and do a proper delete on these pages, after a period of time. If for some reason you need a page to be deleted more quickly than that, you will need to contact a 'sysop' to request this.

[[Category:Help]]

Справка:Redirects

2011-12-24T15:09:19Z

Langator: Новая страница: «Redirects are used to forward users from one page name to another. They can be useful if a particular article is referred to by multiple names, or has alternative pu...»

Redirects are used to forward users from one page name to another. They can be useful if a particular article is referred to by multiple names, or has alternative punctuation, capitalization or spellings.

== Creating a redirect ==
You may start a new page with the name you want to direct from (see [[Help:Starting a new page]]). You can also use an existing page that you are making inactive as a page by going to that page and using the "edit" tab at the top. In either case, you will be inserting the following code at the very first text position of the Edit window for the page:
<nowiki>#REDIRECT [[</nowiki>''pagename''<nowiki>]]</nowiki>
where ''pagename'' is the name of the destination page. The word "redirect" is not case-sensitive, but there must be no space before the "#" symbol. Any text before the code will disable the code and prevent a redirect. Any text or regular content code after the redirect code will be ignored (and should be deleted from an existing page). However, to put or keep the current page name listed in a Category, the usual tag for that category is entered or kept on a line after the redirect code entry.

You should use the 'preview' button below the Edit window, or Alt-P, to check that you have entered the correct destination page name. The preview page will not look like the resulting redirect page, it will look like a numbered list, with the destination page in blue:
1. REDIRECT ''pagename''
If the ''pagename'' as you typed it is not a valid page, it will show in red. Until there is a valid destination page, you should not make the redirect.

== Viewing a redirect ==
After making a redirect at a page, you can no longer get to that page by using its name or by any link using that name; and they do not show up in wiki search results, either. However, near the top of the destination page, a notice that you have been forwarded appears, with the source pagename as an active link to it. Click this to get back to the redirected page, showing the large bent arrow symbol and the destination for the redirect.

By doing this, you can do all the things that any wiki page allows. You can go to the associated discussion page to discuss the redirect. You can view the history of the page, including a record of the redirect. You can edit the page if the redirect is wrong, and you can revert to an older version to remove the redirect.

== Deleting a redirect ==
There's generally no need to delete redirects. They do not occupy a significant amount of database space. If a page name is vaguely meaningful, there's no harm (and some benefit) in having it as a redirect to the more relevant or current page.

If you do need to delete a redirect, e.g. if the page name is offensive, or you wish to discourage people from referring to a concept by that name, then you simply go to the redirect page as mentioned above, and follow the procedures at [[Help:Deleting a page]].

== Double redirects ==
A double redirect is a page redirecting to a page which is itself a redirect, and it will not work. Instead, people will be presented with a view of the next redirect page. This is a deliberate restriction, partly to prevent infinite loops, and partly to keep things simple.

However, you could look out for double redirects and eliminate them by changing them to be 1-step redirects instead. You are most likely to need to do this after a significant [[Help:Moving a page|page move]]. Use the "what links here" toolbox link to find double redirects to a particular page, or use [[Special:DoubleRedirects]] to find them throughout the whole wiki.

== A redirect to a page in the category namespace ==
To prevent a page that redirects to a category from appearing in the category, precede the word "Category" with a colon:
<nowiki>#REDIRECT [[:Category:Glossary]]</nowiki>

[[Category:Help]]