Bug 14293

Summary: [usability] Пустые файлы конфигурации etcnet с комментариями для новых интерфейсов
Product: Sisyphus Reporter: Andrew Kornilov <hiddenman>
Component: alterator-net-generalAssignee: inger <inger>
Status: NEW --- QA Contact: qa-sisyphus
Severity: enhancement    
Priority: P2 CC: cas, evg, ktirf, mike, pilot
Version: unstable   
Hardware: all   
OS: Linux   
Bug Depends on:    
Bug Blocks: 14320    

Description Andrew Kornilov 2008-02-03 04:04:43 MSK
Есть предложение: при создании нового интерфейса класть в каталог с ним все
возможные файлы конфигурации, которые умеет обрабатывать etcnet, которые не
будут содержать ничего, кроме краткого комментария, поясняющего, для чего данный
файл конфигурации. Точнее, некие общие (ipv4address, ipv4route, ipv4rule и т.п.)
+ специфичные для данного типа интерфейса (iwpriv,iwconfig для wifi и т.п.).
Пользователи часто спрашивают, куда и что нужно писать для роутинга, параметров
ethernet-подключения и т.д. Я и сам регулярно это забываю, приходится
заглядывать в скрипты или wiki. Более того, пользователи иногда даже не
подозревают, что с помощью etcnet можно легко и удобно управлять настройками
сети. Поэтому предлагаю составить список общих и интерфейсо-ориентированных
файлов конфигурации и придумать лаконичные комментарии.
Comment 1 Denis Ovsienko 2008-02-03 21:43:51 MSK
Описания опций уже есть в /etc/net/ifaces/default и etcnet-options manpage.
Предлагаете множить их?
Comment 2 Andrew Kornilov 2008-02-03 22:11:13 MSK
(In reply to comment #1)
> Описания опций уже есть в /etc/net/ifaces/default и etcnet-options manpage.
> Предлагаете множить их?
Да я не про опции, а про, например, ipv4rule, iwpriv, iwconfig,
wpa_supplicant.conf, plipconfig, pppinit, pppoptions, pppconnect, pppdisconnect,
brctl, channels.conf, ethtool и т.п.
Всё это нужно выискивать в примерах, на wiki и в man-ах. Хотя логично бы было
класть тот же ethtool в каталог каждого eth-а, да еще и с примером использования
(иначе опять придется искать пример синтаксиса). Из виденных мною дистрибутивов
я припоминаю только один, который приятно использовать и в котором
документирована каждая опция в конфиге и приведены альтернативы для параметров -
SuSE. У остальных - голые переменные и их значения. Что к чему, разобраться
сложно. И у нас это повсеместно. Вот буквально недавно столкнулся снова: сначала
долго искал файл Xkbmap (не знал его имени и пути), в котором с некоторых пор
находятся опции xkb, потом грепал все скрипты из /etc/X11, чтобы найди, что и
как его обрабатывает, потом читал man от этой утилиты. А ведь достаточно было
добавить туда комментарий и пример использования.
Comment 3 Denis Ovsienko 2008-02-04 13:03:40 MSK
Предлагаю определиться со списком опций, которые таким образом будут
пропагандироваться. Например, ethtool в современных серверных сетях всё больше
становится вредной утилитой. Поэтому провоцировать пользователя побаловаться с
ним очень неметодично, это я как сетевой администратор отмечаю.
Comment 4 Andrew Kornilov 2008-02-04 13:21:15 MSK
(In reply to comment #3)
> Предлагаю определиться со списком опций, которые таким образом будут
> пропагандироваться. Например, ethtool в современных серверных сетях всё больше
> становится вредной утилитой. Поэтому провоцировать пользователя побаловаться с
> ним очень неметодично, это я как сетевой администратор отмечаю.
Давай определимся, я по свободе нарисую что-нибудь. А ethtool нужен, мне вот
прямо сейчас. И как туда писать параметры, я не знаю. Полезу опять в скрипты,
смотреть,
как этот файл обрабатывается.
Comment 5 Michael Shigorin 2008-02-04 20:57:47 MSK
Не думаю, что GUI-шная настраивалка -- хороший заменитель RTFM: если кому-либо
придёт в голову "быренько, а потом ещё руками", то скорее поможет симлинк
EXAMPLES из каталога интерфейса в каталог примеров для такого типа интерфейса,
как вот в monit.

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

editing /etc/net/sysctl.conf
creating /etc/net/ifaces/wlan0/
creating /etc/net/ifaces/wlan0/options
# see also etcnet documentation

и их оттуда по штуке в секунду там показывали, или как-то ещё это отдельно
оформить -- чтоб чтение таких логов помогало понять не только объекты
модификации, но и "как" и "зачем", в идеале.  Можешь посмотреть
http://xgu.ru/wiki/LiLaLo (которое понимает, что vi /etc/zuzu.conf -- это
команда редактирования, и делает diff между тем, что было и что вышло, сохраняя
в лог сессии).

Бишь чтоб от работы с настраивалкой можно было не тупеть, а умнеть.

Но это совсем другая сказка, просто ты её напомнил. :)  Этой же предлагаю
INVALID всё-таки назначить: если так сделать, будет слишком много шума и
дополнительных сложностей в изменении второстепенных параметров, если когда их
придётся потрогать в etcnet.  На дурняк причём.
Comment 6 Andrew Kornilov 2008-02-04 22:46:53 MSK
(In reply to comment #5)
> Не думаю, что GUI-шная настраивалка -- хороший заменитель RTFM: если кому-либо
> придёт в голову "быренько, а потом ещё руками", то скорее поможет симлинк
> EXAMPLES из каталога интерфейса в каталог примеров для такого типа интерфейса,
> как вот в monit.
Так в том-то и дело, что я не прошу сделать для этого "кнопки" в alterator-е.
Просто сделать шаблоны для интерфейсов, по типу /etc/skel. Создаем новый -
копируем все файлы конфигурации из шаблона. Advanced user полезет
конфигурировать руками и ему сразу будет помощь. Сейчас просто не ясно, с чего
начинать. Можно, конечно, на досуге перечитать все маны, wiki и документацию. На
практике это мало кому нужно. Вот скажи, Миша, что ты будешь сейчас делать, если
тебе нужно сделать 10Mbit Half-Duplex и ты до этого никогда в etcnet это не делал? 
Это, конечно, больше косметика, но приятная косметика. При всем обилии manpages
конфигурировать что-то в Linux зачастую просто неудобно. Яркий пример: xorg.conf. 
Comment 7 Michael Shigorin 2008-02-04 23:35:22 MSK
(In reply to comment #6)

> Так в том-то и дело, что я не прошу сделать для этого "кнопки" в alterator-е.
(осматривая компонент) Слушай, мужик, ты же правда не на охоту вышел? :-)

> Просто сделать шаблоны для интерфейсов, по типу /etc/skel. Создаем новый -
> копируем все файлы конфигурации из шаблона. Advanced user полезет
> конфигурировать руками и ему сразу будет помощь.
Ну попробуй что-то одно для примера заболванить так, как видишь.

> Сейчас просто не ясно, с чего начинать. Можно, конечно, на досуге перечитать 
> все маны, wiki и документацию. На практике это мало кому нужно.
Но кому-то нужно, поскольку "все пимпочки" обычно страшнее.

> Вот скажи, Миша, что ты будешь сейчас делать, если тебе нужно сделать 10Mbit 
> Half-Duplex и ты до этого никогда в etcnet это не делал?
Прибью втупую в rc.local вызов ethtool, которым не раз пользовался, а что? 8)

> Это, конечно, больше косметика, но приятная косметика. При всем обилии 
> manpages конфигурировать что-то в Linux зачастую просто неудобно.
Я ж не спорю -- просто считаю, что _две_ задачи повышения юзабельности
конфигуратора и не знаю сколько задач по конфигам стоит для начала не сваливать
в кучу и не вешать на конкретный модуль.  Тем паче что этот и интерфейсами-то не
занимается.

Давайте заведём отдельный метабаг или (вот тут лучше) keyword про юзабилити? 
Есть что сказать, но не именно про alterator-net-general же.