13.6 Конфигурационный файл .wgetrc : установка умолчаний contents

Подраздел


13.6 Конфигурационный файл .wgetrc : установка умолчаний

Раз вы знаете какие параметры принимает Wget, вы могли бы пожелать установить часть параметров постоянно в специальном конфигурационном файле .wgetrc, чтобы использовать конкретный набор параметров постоянно. Файл .wgetrc является главным конфигурационным файлом для Wget, однако, если имеется файл $HOME/.netrc, то он будет принят во внимание. Формат файла $HOME/.netrc может быть найден в описании системы Linux, смотрите, например,
man ftp

Wget читает файл $HOME/.wgetrc и интерпретирует ограниченный набор директив.

13.6.1 Где может находиться файл .wgetrc

Во время старта программа Wget читает сначала глобальный конфигурационный файл, который находится по умолчанию в /usr/local/etc/wgetrc и выполняет его.

Затем Wget пробует прочесть пользовательский конфигурационный файл. Имя файла может содержаться в переменной окружения WGETRC. Если эта переменная установлена, то Wget пытается прочесть пользовательский конфигурационный файл. Если файл не найден, то более не предпринимается никаких попыток разыскать пользовательский конфигурационный файл.

Если переменная WGETRC не установлена, то Wget пытается прочесть файл $HOME/.wgetrc. Если содержание глобального и локального конфигурационного файла противоречат друг другу, то принимаются значения из пользовательского конфигурационного файла.

13.6.2 Синтаксис директив в файле .wgetrc

Синтаксис директив в файле .wgetrc прост:
variable = value
variable может также именоваться командой. Правильные значения для value различны для разных команд. Значения нечувствительны к используемому регистру и знакам подч©ркивания. Например, DiR___Prog полностью эквивалентно dirprog.

Пустые строки, строки содержащие в первой позиции знаки # (реш©тка), а также строки, содержащие лишь пробелы, игнорируются.

Если вы хотите очистить какой-то параметр, то это можно сделать, например, так

reject =
тем самым параметру reject присваивается пустое значение.

13.6.3 Директивы в файле .wgetrc

Полный список директив привед©н ниже. Буквы после знака = (равно) означают новое значение, которое принимает параметр. Это может быть on или off, а также 0 или 1. STRING означает непустую строку, а N - неотрицательное целое. К примеру, вы можете написать use_proxy = off, чтобы запретить использование прокси сервера по умолчанию. Вы можете использовать inf для чисел без ограничений по величине.

Большинство, но не все, директивы из файла wgetrc имеют свои эквиваленты в параметрах командной строки.

accept/reject = string
То же самое, что -A/-R (типы файлов).

add_hostdir = on/off
Разрешить/запретить создание файлов, имеющих префикс в виде имени хоста. Параметр -nH выключает это.

continue = on/off
Разрешить/запретить продолжение поиска. Параметр -c разрешает это.

background = on/off
Разрешить/запретить работу в фоновом режиме, то же, что параметр -b, который разрешает его.

base = string
Установить базу для относительных URL, то же, что параметр -b, который разрешает это.

cache = on/off
Когда установлено off, то запрещает кэширование, то же, что -B.

convert links = on/off
Включить/выключить преобразование абсолютных линков в относительные. То же, что -k.

cut_dirs = n
Игнорировать n-ые компоненты удал©нных каталогов.

debug = on/off
Включить/выключить режим отладки. То же что -d.

delete_after = on/off
Включить/выключить удаление файла сразу после завершения копирования. То же, что -delete-after.

dir_prefix = string
Вершина иерархии каталогов. То же, что -P.

dirstruct = on/off
Включить/выключить структуру оглавления. То же, что -x или -nd соответственно.

domains = string
То же самое, что -D.

dot_bytes = n
Определить количество байтов на точку, которые выводятся на экран, чтобы показать процесс копирования (умолчание: 1024 байта).

dots_in_line = n
Определить число точек, которые будут печататься в каждой строке (умолчание: 50 точек).

dot_spacing = n
Определить число точек в кластере (умолчание: 10 точек).

dot_style = string
Определить стиль вывода точек, то же, что -dot-style.

exclude_directories = string
Определить через запятую список каталогов, которые вы хотите исключить из списка на копирование (то же что -X).

exclude_domains = string
То же, что -exclude-domains.

follow_ftp = on/off
Следовать всем FTP линкам в документе HTML, то же, что -f.

force_html = on/off
Если включено (on) рассматривать входной документ как документ HTML, то же что -F.

ftp_proxy = string
Использовать string как FTP прокси, вместо определ©нного в переменной окружения.

glob = on/off
Включить/выключить расширение им©н файлов, то же что -g.

header = string
Определить дополнительный заголовок, то же что -header.

http_passwd = string
Установить пароль для HTTP.

http_proxy = string
Использовать string в качестве HTTP прокси вместо прокси сервера, который определ©н в переменной окружения.

http_user = string
Установить имя пользователя HTTP.

ignore_length = on/off
Когда включено (on), игнорировать содержимое поля заголовка Content-Length, то же самое что -ignore-length.

include_directories = string
Определить раздел©нный запятыми список каталогов, которые вы хотите скопировать, то же самое что -I.

input = string
Читать URL из string, то же что -i.

kill_longer = on/off
Рассматривать данные с размером более, чем определены в поле заголовка Content-length, как неверные и попробовать скопировать их снова. По умолчанию данные сохраняются если их размер равен или больше содержимого поля заголовка Content-length.

logfile = string
Установить имя файла для сохранения протокола выполнения программы. То же, что -o.

login = string
Установить имя пользователя на удал©нном FTP сервере. Умолчание - anonymous.

mirror = on/off
Включить/выключить зеркальное копирование. То же, что -m.

netrc = on/off
Включить/выключить чтение конфигурационного файла $HOME/.netrc.

noclobber = on/off
То же, что -nc.

no_parent = on/off
Запретить поиск вне каталожной иерархии, то же что -no-parent.

no_proxy = string
Использовать string как раздел©нный запятыми список доменов, которые не должны загружаться через прокси сервер вместо списка определ©нного в переменной окружения.

output_document = string
Установить имя выводного файла, то же что -O.

passive_ftp = on/off
Установить режим пассивного FTP, то же что -passive-ftp.

passwd = password
Установить пароль для FTP. Умолчание - username@hostname.domainname.

proxy_user = string
Установить имя пользователя как string, то же что -proxy-user.

proxy_passwd = string
Установить пароль для прокси как string, то же что -proxy-passwd.

quiet = on/off
Включить/выключить режим работы Wget без выдачи диагностических сообщений, то же что -q.

quota = quota
Определить квоту для суммарного объ©ма копируемых данных. Когда квота определена, Wget остановит поиск и копирование после превышения квоты. Квота может быть определена в байтах (умолчание), в Kбайтах (использовать букву k), или в мегабайтах (использовать букву m). Иными словами, quota = 5m означает квоту в 5 мегабайтов.

reclevel = n
Определить уровень рекурсии, то же что -l.

recursive = on/off
Включить/выключить рекурсию, то же что -r.

relative_only = on/off
Следовать лишь относительным линкам в документе HTML, то же что -L.

remove_listing = on/off
Если on, то удаляется оглавление каталогов, полученное программой Wget с удал©нного FTP сервера, по завершении работы программы. То же что -nr.

retr_symlinks = on/off
Если установлено on, то рассматривать символический линк как обычный файл; то же что -retr-symlinks.

robots = on/off
Использовать (on) или не использовать файл /robots.txt. Умолчание: on. Если задумаете менять умолчание, то постарайтесь ясно понять результат.

server_response = on/off
Включить/выключить печати ответов серверов HTTP и FTP; то же что -S.

simple_host_check = on/off
То же, что -nh.

span_hosts = on/off
То же, что -H.

timeout = n
Установить значение максимального ожидания ответа; то же что -T.

timestamping = on/off
Включить/выключить использование отметок времени; то же что -N.

tries = n
Установить число повторов на URL; то же что -t.

use_proxy = on/off
Включить/выключить использование прокси; то же что -Y.

verbose = on/off
Включить/выключить подробную/сокращ©нную диагностику времени выполнения программы Wget; то же что -v/-nv.

wait = n
Ждать n секунд между новыми попытками поиска; то же что -w.

13.6.4 Пример файла .wgetrc

Ниже привед©н пример конфигурационного файла для программы Wget.


###

###    Пример файла инициализации .wgetrc

###



## Вы можете использовать данный файл для изменения поведения программы

## wget, принятого по умолчанию.

## 

## Инициализационный файл программы wget может находиться в 

## /usr/local/etc/wgetrc ╧глобальные умолчания)

## или в $HOME/.wgetrc (персональные умолчания для отдельного

## пользователя).





# Вы можете установить квоту (полезно для начинающих) на суммарный объем

# скопированных файлов в одном сеансе работы программы. За числом может

# следовать 'K' (килобайты) или 'M' (мегабайты). По умолчанию, квота

# не ограничена.

#quota = inf



# Вы можете уменьшить или увеличить число повторов попыток скопировать

# файл с удаленного сервера. Умолчание: 20 попыток.

#tries = 20



# Глубина рекурсии при просмотре удаленных документов HTTP и FTP.

# Умолчание: 5.

#reclevel = 5



# Многие места (серверы, организации) имеют защитные серверы, которые не

# разрешают инициализацию FTP соединений извне организации. Для таких

# серверов вы может использовать режим 'passive' для FTP. Если вы

# находитесь в таком положении, то вам можно установить режим 'passive' по

# умолчанию.

#passive_ftp = off

passive_ftp = on



## 

## Локальные установки (для конкретного пользователя этот файл находится в

## $HOME/.wgetrc. Крайне неудобно устанавливать эти умолчания в глобальном

## инициализационном файле (обычно в /usr/local/etc/wgetrc), поскольку

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

## пользователей.

##



# Установить в 'on', чтобы использовать отметки времени по умолчанию.

#timestamping = off

timestamping = on



# Очень хорошая идея установить этот заголовок. Wget будет посылать его 

# вместе с вашими запросами. Поэтому в случае возникновения проблем,

# администратор сервера сможет связаться с вами. Wget никогда не посылает

# 'From:' по умолчанию.

#header = From: Your Name <username@site.domain>



# Вы можете установить и другие заголовки, например, Accept-Language

# (приемлемый язык). Заголовок Accept-Language не посылается по умолчанию.

#header = Accept-Language: en



# Вы можете установить по умолчанию прокси сервер, который будет

# использовать Wget. Эта установка заменит прокси сервер, который

# содержится в переменной окружения.

#http_proxy = http://proxy.yoyodyne.com:18023/

http_proxy = http://proxy.pnpi.spb.ru:81/

ftp_proxy = http://proxy.pnpi.spb.ru:81/



# Если вы не хотите использовать прокси по умолчанию, то установите 'off'.

#use_proxy = on

use_proxy = on



# Вы можете сконфигурировать внешний вид диагностики о процессе

# копирования. Правильные значения: default, binary, mega, micro.

#dot_style = default



# Установка данного параметра в 'off' будет означать, что Wget не примет

# во внимание файл /robots.txt на удаленном сервере. Прежде чем менять

# это умолчание, пожалуйста ознакомьтесь, что это будет означать конкретно

# для вас.

#robots = on



# Может оказаться полезным установить некоторый интервал между очередными

# попытками скопировать файл с удаленного сервера. Интервал может

# измеряться в секундах (без обозначений), 'm' - минуты, 'h' - часы, 'd' -

# дни.

#wait = 0



# Вы можете потребовать создать каталожную структуру, даже если вы

# копируете единственный файл. Для этого надо установить 'on'.

#dirstruct = off



# Вы можете включить рекурсивный поиск по умолчанию ('on').

#recursive = off



# Чтобы сказать Wget, что надо следовать по FTP линкам из документов HTML,

# установите 'on'.

#follow_ftp = off


contents
Обновлено: 16.03.2015