touch - изменяет время последнего доступа и/или модификации файла

НАЗВАНИЕ
touch - изменяет время последнего доступа и/или
модификации файла

СИНТАКСИС
touch [-acm][-r ref_file|-t время] [--]файл...

Устаревшая версия:
touch [-acm][ugly_time] файл...

Версия GNU:
touch [-acfm] [-r файл] [-t decimtime] [-d time]
[--time={atime,access,use,mtime,modify}] [--date=время]
[--reference=файл] [--no-create] [--help] [--version] [--]
файл...

ОПИСАНИЕ
touch изменяет время последнего доступа и/или время
последней модификации к каждому заданному аргументу файл.
При изменении, время становится равным текущему; или, если
задана опция -r, время последнего доступа и последней
модификации становится таким же, как и время файла
ref_file. Если задана опция -t, то устанавливается время
последнего доступа и последней модификации заданное
аргументом время. Оба времени изменяются, если не задана
ни одна из опций (-a или -m) или если заданы обе из них.
Если задана только опция -a или только -m, то изменяться
будет, соответственно, только время последнего доступа к
файлу или время последней его модификации. Если заданный
файл еще не существует, то он создается (как пустой файл с
правами доступа 0666, с учетом umask), если не задана
опция -c.

ОПЦИИ POSIX
-a Изменяет время последнего доступа к файл.

-c Не создает файл.

-m Изменяет время последней модификации файл.

-r ref_file
Использует соответствующее время файла ref_file в
качестве нового значения изменяемого времени (или
времён).

-t время
Использует заданное время в качестве нового
значения изменяемого времени (или времён).
Аргумент является десятичным числом вида
[[ВВ]ГГ]ММДДччмм[.СС]
с очевидными обозначениями (ВВ - век, ГГ - год, ММ
- месяц, ДД - день, чч - часы, мм - минуты, СС -
секунды). Если значение ВВ не задано, то значение
года ВВГГ берется из диапазона 1969-2068. Если не
задано значение СС, то им становится 0. Диапазон
секунд должен быть равен 0-61, чтобы можно было
указать високосную секунду. Считается, что время,
получающееся в результате, соответствует времени
той зоны, которая задана переменной окружения TZ.
Если в результате получилось время до 1 января 1970
года, то будет выдано сообщение об ошибке.

-- Используется для обозначения конца списка опций.

УТОЧНЕНИЯ СТАНДАРТА POSIX
Вторая форма вызова имеет неудачный синтаксис, который
может вызвать некоторую двусмысленность, так как
непонятно, что именно задает аргумент ugly_time: время или
файл. Если не указаны опции -r и -t и задано не менее
двух аргументов, причем первый аргумент является
восьмеричным или десятичным числом, то считается, что
аргумент ugly_time задает время. Формат ugly_time
выглядит так: ММДДччмм[гг], причем гг в диапазоне 69-99
означает 1969-1999, а в случае, когда значение гг не
задано, это означает текущий год. Данная форма вызова
устарела.

ПОДРОБНОСТИ ВЕРСИИ GNU
Если первый файл может быть правильным аргументом опции -t
и время не задано с помощью опций -d, -r или -t и не задан
аргумент `--', то этот файл интерпретируется как время для
других файлов, а не как имя файла.

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

ОПЦИИ GNU
-a, --time=atime, --time=access, --time=use
Изменяет только время последнего доступа.

-c, --no-create
Не создает файлы, которые не существуют.

-d, --date=время
Использует значение время вместо значения текущего
времени. Оно может содержать названия месяцев,
временные зоны, `am' и `pm', и т.д.

-f Игнорируется для совместимости с BSD-версией
touch(1).

-m, --time=mtime, --time=modify
Изменяет только время последней модификации файла.

-r file, --reference=файл
Использует время указанного файл вместо текущего
времени.

-t время
Здесь время имеет формат ММДДччмм[[ВВ]ГГ][.сс]
Использовать аргумент (месяц, день, часы, минуты,
век (необязательно), год, секунды) вместо текущего
времени. Заметим, что этот формат нарушает
спецификацию POSIX.

СТАНДАРТНЫЕ ОПЦИИ GNU
--help Выводит подсказку на стандартный вывод и завершает
свою работу.

--version
Выводит информацию о версии программы на
стандартный вывод и завершает свою работу.

-- Служит для обозначения конца списка опций.

ОКРУЖЕНИЕ
Для интерпретации заданного времени используется
переменная TZ. Переменные LANG, LC_ALL, LC_COLLATE,
LC_CTYPE и LC_MESSAGES используются обычным образом.

СООТВЕТСТВИЕ
POSIX 1003.2 описывает синтаксис аргумента опции -t,
который отличается от того синтаксиса, который
используется в реализации GNU.

ПРИМЕР ИСПОЛЬЗОВАНИЯ
Команда touchfoo создаст файл foo, если он не существует,
и изменит время последней модификации на текущее. Это
очень часто используется для управления действиями
программы make.

ЗАМЕЧАНИЯ
Данная страница описывает версию touch из пакета fileu-
tils-4.0; другие версии могут немного отличаться от
данной. Исправления и дополнения присылайте по адресу:
aeb@cwi.nl. Отчеты об ошибках в этой программе присылайте
по адресу: fileutils-bugs@gnu.ai.mit.edu.