ADMIN(1)
НАЗВАНИЕ
admin - создание и административные функции для
SCCS-файлов
СИНТАКСИС
admin [-n] [-i[файл]] [-rверсия] [-t[файл]] [-fфлаг[значение]]
[-dфлаг[значение]] [-aпользователь] [-eпользователь]
[-m[список_номеров_запросов_на_модификацию]] [-y[комментарий]]
[-h] [-z] файл ...
ОПИСАНИЕ
Команда admin используется для создания новых SCCS-файлов и изменения параметров существующих. Аргументы admin, которые могут задаваться в любом порядке, состоят
из опций и имен файлов (отметим, что простые имена
SCCS-файлов должны начинаться с s.). Если поименованный
файл не существует, он создается, и его характеристики
устанавливаются в соответствии с указанными аргументами. Характеристикам, для которых не заданы соответствующие аргументы, присваиваются значения по умолчанию.
Если поименованный файл существует, его характеристики,
соответствующие указанным аргументам, изменяются, а остальные остаются без изменений.
Если задано имя каталога, admin обрабатывает все файлы
в этом каталоге, начинающиеся с s.; файлы, к которым
нет доступа на чтение, игнорируются без дополнительных
сообщений. Если задано имя -, происходит чтение со
стандартного ввода, каждая строка при этом трактуется
как имя SCCS-файла, подлежащего обработке. Файлы, не
начинающиеся с s., и файлы, к которым нет доступа на
чтение, также игнорируются без дополнительных сообщений.
Каждая опция об ясняется ниже для одного обрабатываемого файла; при нескольких файлах она применяется к каждому из них.
| -n | Создать новый SCCS-файл |
| -i[файл] |
Текст для нового SCCS-файла взять из указанного
файла. Этот текст составляет начальную версию (по
поводу нумерации версий см. опцию -r). Если используется опция -i, а файл не задан, текст берется со стандартного ввода, до достижения конца файла. Если опция -i отсутствует, SCCS-файл создается
пустым. Командой admin с опцией -i можно создать
только один файл, без опции -i можно создать несколько (пустых) файлов. Опция -i подразумевает опцию -n. |
| -rверсия |
Номер начальной версии файла. Эта опция используется совместно с опцией -i. Если -r отсутствует,
подразумевается версия 1. Уровень начальной версии
всегда 1, то есть по умолчанию начальная версия
получает имя 1.1. |
| -t[файл] |
Описание SCCS-файла взять из файла. Если опция -t
используется при создании SCCS-файла (опции -n
и/или -i) файл с описанием обязателен. Для существующего файла: (1) опция -t без имени файла приводит к удалению описания SCCS-файла, (2) опция -t с
именем файла приводит к замене существующего описания SCCS-файла на новое, содержащееся в файле. |
| -fфлаг[значение] |
Эта опция определяет флаг, и, возможно, значение
флага, который помещается в SCCS-файл. В одной команде admin могут указываться несколько опций -f.
Допустимые флаги и их значения:
- b
- Допустимость использовать опцию -b команды
get(1) для создания ответвлений.
- cверсия
- Максимальная версия (до 9999), которая может
быть выбрана командой get(1) для редактирования. Значение по умолчанию (если флаг c не указан) равно 9999.
- fверсия
- Минимальная версия (до 9999), которая может
быть выбрана командой get(1) для редактирования. Значение по умолчанию (если флаг f не указан) равно 1.
- dс_идентификатор
- Номер версии по умолчанию, который будет использоваться командой get(1).
- i
- Приводит к тому, что сообщение "No id keywords
(ge6)", выдаваемое программами get(1) или
delta(1), интерпретируется как фатальная ошибка. В отсутствие этого флага указанное сообщение является предупреждением; оно выдается, если в тексте, извлеченном из SCCS-файла или записанном в него, не оказалось ключевых слов
SCCS [см. get(1)].
- j
- Допускается использование нескольких команд
get(1) одновременно для редактирования одной и
той же версии SCCS-файла. Это позволяет вносить
параллельно несколько изменений в одну и ту же
версию SCCS-файла.
- lсписок
- Список версий, в которые запрещено вносить изменения (то есть команда get -e для этих "закрытых" версий завершается неудачей). Синтаксис
списка следующий:
список ::= элемент | список,элемент
элемент ::= номер_версии | a
Символ a означает все версии в SCCS-файле.
- n
- Приводит к тому, что delta(1) при создании новой версии будет создавать пустыми все пропущенные версии (например, создавая версию 5.1
после версии 2.7, имеем пропущенные версии 3 и
4). Эти пустые версии могут затем быть использованы для новых ветвей. Отсутствие флага n
приводит к отсутствию пропущенных версий в
SCCS-файле, использовать их в будущем для новых
ветвей нельзя.
- qтекст
- Производится подстановка текста вместо всех
вхождений %Q% в информацию, извлеченную из
SCCS-файла с помощью get(1).
- mимя
- Производится подстановка имени вместо всех
вхождений %M% в тексте, который извлечен из
SCCS-файла с помощью get(1). Если флаг m не
указан, вместо %M% подставляется имя SCCS-файла, из которого удалены начальные s..
- tтип
- Производится подстановка типа вместо всех вхождений %Y% в тексте, который извлекается из
SCCS-файла с помощью get(1).
- v[программа]
- Приводит к тому, что delta(1) запрашивает в качестве причины создания версии номер запроса на
модификацию. Необязательный параметр указывает
имя программы проверки корректности этого номера (см. delta(1)). Если этот флаг указывается
при создании SCCS-файла, обязательно должна
быть указана опция -m, хотя бы с пустым значением.
|
| -dфлаг[значение] |
Приводит к удалению указанного флага из SCCS-файла. Опция -d может быть указана только для существующих SCCS-файлов. В одной команде admin можно
указать несколько опций -d. Допустимые флаги см. в
описании опции -f. |
| lсписок |
Список "закрытых" версий, которые должны быть
"открыты". Синтаксис списка см. в описании флага l опции -f. |
| -aпользователь |
Имя пользователя или числовой идентификатор группы
добавляется к списку пользователей, которые имеют
право редактировать версии в SCCS-файле. Указание
идентификатора группы эквивалентно указанию имен
всех пользователей, принадлежащих группе. В одной
команде admin можно указать несколько опций -a.
Количество имен пользователей и идентификаторов
групп в списке имеющих доступ не ограничено. Если
этот список пуст, никто не может редактировать
версии. |
| -eпользователь |
Имя пользователя или числовой идентификатор группы
удаляется из списка пользователей, которые имеют
право редактировать версии в SCCS-файле. Указание
идентификатора группы эквивалентно указанию имен
всех пользователей, принадлежащих группе. В одной
команде admin можно указать несколько опций -e. |
| -m[список_номеров_ запросов_на_модификацию] |
Список_номеров_запросов_на_модификацию включается
в SCCS-файл в качестве причины создания начальной
версии тем же способом, что и delta(1). Флаг v
должен быть установлен. Номера запроса проверяются
на корректность, если флаг v содержит значение
(имя программы проверки). Если флаг v не указан
или программа проверки выявила некорректность, выдается диагностика. |
| -y[комментарий] |
Текст комментария вносится в SCCS-файл как комментарий к начальной версии, тем же способом, что и
delta(1). Опущенная опция -y приводит к занесению
в файл стандартного комментария:
date and time created гг/мм/дд чч:мм:сс
by пользователь
Опция -y может быть указана только совместно с опциями -i и/или -n (то есть при создании нового
SCCS-файла). Если комментарий больше одного слова,
он должен быть заключен в двойные кавычки. |
| -h |
Admin проверяет структуру SCCS-файла [см. sccsfile(5)] и сравнивает вновь вычисленную контрольную
сумму (сумму кодов всех символов в SCCS-файле,
кроме символов первой строки) с контрольной суммой, хранящейся в первой строке SCCS-файла. Выдается соответствующая диагностика. Эта опция запрещает запись в файл, аннулирует все остальные опции
и имеет смысл только для существующих файлов. |
| -z |
Контрольная сумма SCCS-файла перевычисляется и записывается в первую строку (см. выше опцию -h).
Использование этой опции для поврежденного файла
может привести к тому, что повреждение пройдет незамеченным. |
ФАЙЛЫ
Простые имена SCCS-файлов должны иметь вид s.имя_файла.
Новые SCCS-файлы получают права доступа 444 [см.
chmod(1)]. Безусловно, для создания файла требуются
права записи в каталог. Всю запись admin производит во
временный файл с именем x.имя_файла [см. get(1)], создаваемый с правами доступа 444 (если команда admin создает новый файл) или с теми же правами доступа, что и
существующий SCCS-файл. После успешного завершения выполнения admin, старый SCCS-файл удаляется, а временный
переименовывается. Это гарантирует, что изменения вносятся в SCCS-файл только при отсутствии ошибок.
Рекомендуется, чтобы все каталоги, содержащие SCCS-файлы, имели права доступа 755, а сами SCCS-файлы - права
доступа 444. Указанные права для каталога позволяют модифицировать SCCS-файлы, находящиеся в каталоге, только
владельцу каталога. Права для SCCS-файлов предотвращают
модификацию этих файлов иначе, чем через команды SCCS.
Если все-таки по какой-либо причине потребуется модифицировать SCCS-файл, права доступа могут быть изменены
на 644, что позволит владельцу использовать для модификации редактор ed(1). Будьте осторожны и внимательны!
Модифицированный файл должен быть обязательно обработан
командой admin -h для проверки корректности, а затем
admin -z для генерации правильной контрольной суммы.
После этого рекомендуется еще раз выполнить команду admin -h для контроля нормального состояния SCCS-файла.
Admin также создает файл-замок z.имя_файла, который используется для предотвращения одновременного доступа к
SCCS-файлу несколькими пользователями. Дополнительную
информацию см. в get(1).
СМ. ТАКЖЕ
delta(1), ed(1), get(1), help(1), prs(1), what(1).
sccsfile(4) в Справочнике программиста.
ДИАГНОСТИКА
Для раз'яснений пользуйтесь командой help(1).
|
