GET(1)

НАЗВАНИЕ

get - извлечение версии из SCCS-файла

СИНТАКСИС

get [-rс_идентификатор] [-cкон_время] [-iсписок] [-xсписок] [-k] [-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] [-wтекст] [-aпорядковый_номер] файл ...

ОПИСАНИЕ

Команда get генерирует текстовый файл из указанных SCCS-файлов в соответствии с опциями. Опции могут задаваться в любом порядке и относятся ко всем указанным SCCS-файлам. Если указано имя каталога, get обрабатывает все файлы в этом каталоге, начинающиеся с s.; файлы, к которым нет доступа на чтение, игнорируются без дополнительных сообщений. Если указано имя -, происходит чтение со стандартного ввода; каждая строка при этом трактуется, как имя SCCS-файла, подлежащего обработке. Файлы, не начинающиеся с s., и файлы, к которым нет доступа на чтение, также игнорируются без дополнительных сообщений.

Сгенерированный текст обычно записывается в так называемый g-файл. Имя g-файла получается путем удаления начальных s. из имени SCCS-файла (см. ниже).

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

-rс_идентификатор Извлечь из SCCS-файла версию по указанному с_иден- тификатору (SID, SCCS IDentification string). Таблица 1 (ниже) показывает для наиболее распространенных случаев, как зависит извлекаемая версия от указанного с_идентификатора, а также каким будет с_идентификатор новой версии после создания командой (если в get использована опция -e).

-cкон_время Кон_время имеет формат:

гг[мм[дд[чч[мм[сс]]]]]

Не включать в генерируемый файл версии SCCS-файла, которые созданы после указанного кон_времени. Опущенные цифры по умолчанию имеют максимально возможные значения, например -c7502 эквивалентно -c750228235959. Произвольное число любых нецифровых символов может разделять пары цифр, например можно задать кон_время в виде "-c77/2/2 9:22:25". Это позволяет использовать ключевые слова %E% и %U% (см. ниже) для вложенных get, например, в сеансе работы с командой :

~!get "-c%E% %U%" s.file

- e Показывает, что команда get делается для редактирования или последующего добавления версии в SCCS-файл с помощью . Если для какой-либо версии в SCCS-файле сделан get, последующие версии с тем же с_идентификатором отвергаются до тех пор, пока не будет выполнена команда delta [или в SCCS-файле не будет установлен флаг j, см. ]. Допускается использование команды get -e одновременно для разных с_идентификаторов.

Если сгенерированный командой get с опцией -e g-файл случайно испорчен, он может быть перегенерирован командой get с опцией -k вместо -e.

Ограничение прав доступа к версиям SCCS-файла организуется с помощью запоминаемого в файле максимального и минимального номера версии, доступной для редактирования, и списка пользователей, которые могут редактировать версии [см. ]. При использовании опции -e все эти права проверяются.

-b Используется вместе в опцией -e для указания, что новая версия должна начинать ответвление, как показано в таблице 1. Опция -b игнорируется, если в SCCS-файле отсутствует флаг b [см. ] или извлекаемая версия не является терминальной (то есть у нее есть преемники в дереве версий SCCS-файла). Для нетерминальных версий всегда будет строиться ответвление.

-iсписок Список версий, которые должны быть включены при генерации файла. Список имеет следующий синтаксис:

::= | ,

::= СИД | СИД-СИД

где СИД - сокращение от с_идентификатор - может иметь любой формат, упомянутый в колонке "Указанный СИД" таблицы 1. Интерпретация значений показана в колонке "Извлеченный СИД" таблицы 1.

-xсписок Список версий, которые не должны быть включены при генерации файла. Формат списка см. в описании опции -i.

-k Подавить при генерации подстановку значений вместо ключевых слов (см. ниже). Опция -k подразумевается опцией -e.

-l[p] Выдать сведения о версиях в l-файл. Если используется опция -lp, l-файл не создается, все сведения пишутся на стандартный вывод. Формат l-файла описан ниже.

-p Текст, извлеченный из SCCS-файла, пишется на стандартный вывод. G-файл не создается. Все то, что обычно пишется на стандартный вывод, при этом, если указана опция -s, не выводится никуда (исчезает), а если опция -s опущена, переадресуется в стандартный протокол.

-s Подавить выдачу на стандартный вывод. Выдача в стандартный протокол (в том числе сообщения о фатальных ошибках) при этом не подавляется.

-m Перед каждой строкой, извлеченной из SCCS-файла, помещается с_идентификатор версии, в которой она появилась, в следующем формате:

с_идентификатор табуляция строка

- n Перед каждой строкой, извлеченной из SCCS-файла, помещается значение ключевого слова %M% (см. ниже) в соответствии с форматом:

%M% табуляция строка

Если опции -m и -n используются одновременно, формат будет таким:

%M% табуляция с_идентификатор табуляция строка

-g Подавить генерацию g-файла. Эта опция используется для генерации l-файла или для проверки существования конкретного с_идентификатора.

-t Получить доступ к самому последнему (по времени) состоянию указанной версии (например -r1) или версии и уровню (например -r1.2).

-wтекст Подставить текст вместо всех вхождений %W% в извлекаемый файл.

-aпорядковый_номер Порядковый номер версии SCCS-файла, которая должна быть извлечена (см. ). Эта опция используется командой , пользователям ее применять не рекомендуется. Если указаны одновременно опции -r и -a, принимается опция -a. Необходимо соблюдать осторожность при одновременном использовании опций -a и -e, так как с_идентификатор создаваемой версии может оказаться не тем, который ожидается. Для управления с_идентификатором создаваемой версии можно использовать одновременно опции -a, -e и -r.

Для каждого обрабатываемого файла команда get выводит на стандартный вывод с_идентификатор и количество строк, извлеченных из SCCS-файла. Если используется опция -e, вслед за с_идентификатором, к которому получен доступ, следует вновь созданный с_идентификатор. Если в команде указано более одного файла, указан каталог или стандартный ввод, перед обработкой каждого файла выводится его имя с предшествующим переводом строки. Если используется опция -i, выводятся включаемые версии, за которыми следует слово Included. Если используется опция -x, выводятся исключаемые версии, за которыми следует слово Excluded.

Таблица 1. Определение с_идентификатора (СИД)

Указанный СИД* Опция -b**** Дополнительные условия Извлеченный СИД СИД создаваемой версии

<пусто>*****	нет	R по умолч.=mR	mR.mL	mR.(mL+1)
<пусто>*****	да	R по умолч.=mR	mR.mL	mR.mL.(mB+1).1
R	нет	R > mR	mR.mL	R.1***
R	нет	R = mR	mR.mL	mR.(mL+1)
R	да	R > mR	mR.mL	mR.mL.(mB+1).1
R	да	R = mR	mR.mL	mR.mL.(mB+1).1
		R < mR и
R	-	R не существует hR.mL**	hR.mL.(mB+1).1
		R < mR и
R	-	R существует	R.mL	R.mL.(mB+1).1
R.L	нет	L = mL	R.L	R.(L+1)
R.L	да	L = mL	R.L	R.L.(mB+1).1
R.L	-	L < mL	R.L	R.L.(mB+1).1
R.L.B	нет	B = mB	R.L.B.mS	R.L.B.(mS+1)
R.L.B	да	B = mB	R.L.B.mS	R.L.(mB+1).1
R.L.B.S	нет	B = mB	R.L.B.S	R.L.B.(S+1)
R.L.B.S	да	B = mB	R.L.B.S	R.L.(mB+1).1
R.L.B.S	-	B < mB	R.L.B.S	R.L.(mB+1).1

* ** *** **** *****

R, L, B, и S - это соответствующие компоненты с_идентификатора: выпуск (release), уровень (level), ветвь (branch), модификация (sequence); m означает максимум. Таким образом, например, R.mL означает максимальный номер уровня в версии R; R.L.(mB+1).1 означает первый номер новой ветви (то есть максимальный номер ветви плюс 1) уровня L версии R. При указании с_идентификатора в виде R.L, R.L.B или R.L.B.S каждый из указанных компонентов должен существовать.

hR - это максимальная существующая версия, меньшая, чем указанная несуществующая версия R.

Используется для создания первой версии нового выпуска.

Опция -b работает, только если в SCCS-файле присутствует флаг b [см. ]. Если в колонке указан -, то значение может быть любым.

Применимо, только если флаг d (с_идентификатор по умолчанию) в файле не установлен. Если флаг d установлен, используется его значение, как если бы оно было указано в команде. Тем самым применяются другие строки таблицы 1.

Идентифицирующие ключевые слова

Идентифицирующая информация вставляется в извлекаемый текст вместо идентифицирующих ключевых слов. В текстах, сохраняемых в SCCS-файлах, могут использоваться следующие ключевые слова: %M% %I% %R% %L% %B% %S% %D% %H% %T% %E% %G% %U% %Y% %F% %P% %Q% %C% %Z% %W% %A%

Имя модуля: либо значение флага m [см. ], либо, если флаг m отсутствует, простое имя SCCS-файла в котором удалены передние s..

С_идентификатор (%R%.%L%.%B%.%S%) извлекаемого текста.

Выпуск (release).

Уровень (level).

Ветвь (branch).

Модификация (sequence).

Текущая дата (гг/мм/дд).

Текущая дата (мм/дд/гг).

Текущее время (чч:мм:сс).

Дата создания последней версии (гг/мм/дд).

Дата создания последней версии (мм/дд/гг).

Время создания последней версии (чч:мм:сс).

Тип модуля: значение флага t в SCCS-файле [см. ].

Простое имя SCCS-файла.

Полное имя SCCS-файла.

Значение флага q в SCCS-файле [см. ].

Текущий номер строки. Это ключевое слово предназначено для идентификации ошибок типа "этого не должно быть". Оно не предназначено для использования в каждой строке для нумерации.

Четырехсимвольная цепочка @(#), распознаваемая программой .

Сокращение для создания строк выполняемых файлов версии 5 для : %W% = %Z%%M% табуляция %I%

Сокращение для создания строк выполняемых файлов не версии 5 для : %A% = %Z%%Y% %M% %I%%Z%

<

Команда get создает несколько дополнительных файлов: g-файл, l-файл, p-файл и z-файл. Имена дополнительных файлов формируются из имени SCCS-файла: простое имя SCCS-файла должно начинаться с s.; имя g-файла получается путем удаления s., имена остальных файлов строятся путем замены первого символа s соответственно на l, p, z. Например, для файла s.xyz.c, дополнительные файлы будут иметь имена соответственно xyz.c, l.xyz.c, p.xyz.c и z.xyz.c.

G-файл, содержащий сгенерированный текст, создается в текущем каталоге (если не используется опция -p). G-файл создается даже если из SCCS-файла get не извлек ни одной строки. За идентификатор владельца берется реальный идентификатор пользователя. Если используется опция -k, права доступа к файлу устанавливаются равными 644, иначе 444. Реальный идентификатор пользователя должен быть таким, чтобы позволить запись в текущий каталог.

L-файл содержит таблицу, показывающую, какие версии были использованы при генерации текста. L-файл создается в текущем каталоге при использовании опции -l; его права доступа 444, идентификатор владельца равен реальному идентификатору пользователя. Реальный идентификатор пользователя должен быть таким, чтобы позволить запись в текущий каталог.

Строки l-файла имеют следующий формат:

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

I: Включена по опции -i. X: Исключена по опции -x. C: Время не соответствует указанному в опции -c.

Пробел.
С_идентификатор.
Табуляция.
Дата и время создания (гг/мм/дд чч:мм:сс).
Пробел.
Входное имя пользователя, создавшего версию.

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

P-файл используется для передачи информации от get с опцией -e к delta. Его содержимое также используется для предотвращения последующего выполнения get -e с тем же с_идентификатором, пока не будет выполнена команда delta или в SCCS-файле не будет установлен флаг j, [см. admin(1)]. P-файл создается в каталоге, содержащем SCCS-файл, действующий идентификатор пользователя должен быть таким, чтобы разрешить запись в этот каталог. Права доступа к файлу равны 644, идентификатор владельца равен действующему идентификатору пользователя. Формат p-файла следующий: извлеченный с_идентификатор, пробел, новый с_идентификатор, пробел, имя, соответствующее реальному идентификатору пользователя, пробел, дата и время выполнения get, пробел, аргумент опции -i (если есть), пробел, аргумент опции -x (если есть), перевод строки. В p-файле может быть различное число строк; никакие две из них не могут содержать один и тот же новый с_идентификатор.

Z-файл служит как файл-замок для защиты от одновременных изменений. Его содержимое - двоичный двухбайтный идентификатор процесса get, создавшего z-файл. Z-файл создается в каталоге, содержащем SCCS-файл, на время выполнения get. Права доступа к z-файлу 444, остальное то же, что и для p-файла.

ФАЙЛЫ

g- файл Существует до выполнения команды delta; удаляется после ее завершения. p-файл Существует до выполнения команды delta; может остаться после ее завершения. q-файл Создается во время выполнения команды delta; удаляется после ее завершения. x-файл Создается во время выполнения команды delta; переименовывается в SCCS-файл после ее завершения. z-файл Создается во время выполнения команды delta; удаляется также во время ее вы- полнения. d-файл Создается во время выполнения команды delta; удаляется после ее завершения. /usr/bin/bdiff Программа для выявления различий между "извлеченным" и g-файлом.

СМ. ТАКЖЕ

admin(1), , , , . sccsfile(4) в Справочнике программиста.

ДИАГНОСТИКА

Для раз яснений пользуйтесь командой .

СЮРПРИЗЫ

Если действующий идентификатор пользователя позволяет запись (явно или неявно) в каталог, содержащий SCCS-файлы, а реальный идентификатор пользователя этого не позволяет, то при использовании опции -e в команде get может быть указано только одно имя файла.

Содержание раздела