Путь к каталогу тома в формате windows unc

Картинка с сайта: habr.com

Пути файловых систем в Windows страннее, чем можно подумать. В любой производной от Unix системе пути на удивление просты: если нечто начинается с /, то это путь. Но всё совершенно иначе в Windows, которая имеет озадачивающее разнообразие схем составления пути.

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

Стоит заметить, что статья ограничивается только тем типом путей, который видит пользователь приложений Windows (обусловленный Win32 API). Под этим слоем есть ещё больше любопытного, в основном касающегося тех, кто пишет драйверы оборудования и тому подобное.

Вкратце

Форматы абсолютных путей

Форматы относительных путей

Запрещённые символы

Ограничения длины

Схемы путей Windows

В Windows существует три разных вида абсолютного пути и три разных типа относительного пути.

Абсолютные пути

Абсолютные, или полные пути — это завершённые пути, сами по себе уникальным образом идентифицирующие местоположение в файловой системе.

Пути к диску

Пути к диску — это старые добрые пути, которые мы знаем и любим, они состоят из буквы диска и последовательности папок.

D:\Doughnut preferences\With jam in

UNC-пути

UNC расшифровывается как Universal Naming Convention, это описание файлов, начинающееся с \\, часто используемое для ссылок на сетевые накопители. Первый сегмент после \\ — это хост, который может быть или сервером с именем, или IP-адресом:

\\Work\Hard
\\192.168.1.15\Hard

UNC-пути также можно использовать для доступа к локальным дискам:

\\localhost\C$\Users\Andrew Fletcher
\\127.0.0.1\C$\Users\Alan Wilder

Или с использованием имени компьютера:

\\Pipeline\C$\Users\Martin Gore

Символ $ в C$ обозначает скрытую административную общую папку; он не заменяет двоеточие рядом с именем диска :. Общие диски в стиле C$ — это просто удобные ярлыки, автоматически создаваемые Windows. Доступ к дискам через них возможен, только если вы вошли как администратор.

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

Пути к устройству

Путь к устройству начинается с одного из следующих фрагментов:

• \\?\
• \\.\

Кроме файлов и папок их можно использовать для адресации физических устройств (дисков, дисплеев, принтеров и так далее). Не совсем то, что вы используете в повседневном процессе управления файлами, но это полезно знать, если вы когда-нибудь найдёте что-то подобное.

Синтаксис доступа к локальной папке выглядит как один из этих вариантов:

\\?\Z:\Animals\Cute
\\.\Z:\Animals\Cunning

Если вам нужно ещё больше загадочности, то можно также подставить эквивалентный Z: идентификатор устройства:

\\?\Volume{59e01a55-88c5-411f-bf0b-92820bdb2548}\Animals\Cryptic

Здесь Volume{59e01a55-88c5-411e-bf0a-92820bdb2549} — это идентификатор дискового тома, на котором находится Z: в компьютере.

Также существует специальный синтаксис для описания UNC-путей как путей к устройству:

\\?\UNC\localhost\Z$\Animals\Curious

В путях к устройству часть, идущая после \\?\ или \\.\ — это имя, определённое во внутреннем пространстве имён Object Manager Windows. Те, кому любопытно исследовать это пространство имён, могут скачать инструмент WinObj и посмотреть.

Нормализованные и литеральные пути к устройству

Так в чём же разница между \\?\ и \\.\?

В обычном случае, когда вы передаёте путь операционной системе Windows, она очищает его, прежде чем использовать. Этот процесс называется нормализацией, подробнее о нём мы поговорим ниже.

Путь \\?\ пропускает этот этап очистки, а \\.\ не пропускает. Поэтому можно назвать пути \\?\ литеральными путями к устройству, а \\.\ — нормализованными путями к устройству.

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

Относительные пути

Относительные пути — это неполные пути, которые для уникальной идентификации местоположения необходимо скомбинировать с другим путём.

Пути, относительные к текущей папке

Эти пути используют в качестве начальной точки текущую папку, например, .\Torquay относится к подпапке текущей папки, а ..\Wales относится к подпапке родителя текущей папки.

Папки, относительные к корню текущего диска

Если начать путь с одной \, то путь интерпретируется как относительный к корню текущего диска. Поэтому если вы находитесь в любом месте диска E: и введёте \Africa, то окажетесь в E:\Africa.

Когда доступ к текущей папке выполняется через UNC-путь, то путь, относительный к текущему диску, интерпретируется относительно к общей корневой папке, допустим \\Earth\Asia.

Пути, относительные к текущей папке диска

Эти более редко используемые пути указывают диск без обратной косой черты, например E:Kreuzberg, и интерпретируются относительно к текущей папке этого накопителя. На самом деле это имеет смысл только в контексте оболочки командной строки, отслеживающей текущую рабочую папку для каждого диска.

Это единственный тип путей, не поддерживаемый Fileside, потому что в нём нет понятия текущей папки каждого диска. Текущую папку имеют только панели.

Нормализация

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

• Замена косых черт (/) на обратные косые черты (\)
• Сворачивание повторяющихся разделителей в виде обратных косых черт в один
• Резолвинг относительных путей заменой всех . или ..
• Отсечение завершающих пробелов и точек

Таким образом, в общем случае можно указывать пути Windows при помощи косых черт.

Правила именования в Windows

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

Запрещённые символы

В имени нельзя использовать следующие символы:

< > " / \ | ? *

Также исключаются любые непечатаемые символы со значением ASCII меньше 32.

Хитрое двоеточие

В большинстве случаев : также запрещено.

Однако существует экзотическое исключение в виде изменённых потоков данных NTFS, в которых двоеточие используется в качестве разделителя внутри имени. Малоизвестно, что в некоторых контекстах можно хранить внутри файла скрытый фрагмент данных, добавляя к его имени суффикс, которому предшествует двоеточие.

Опасная точка

Символ . допустим внутри или в начале имени, но запрещён в конце.

Начинающие и завершающие пробелы

Любопытно, что Windows допускает пробелы в начале, но не в конце имён. Так как имя с пробелами в начале и конце часто выглядит похожим на имя без пробелов, обычно это ужасная идея, и при переименовании или создании файлов Fileside автоматически удаляет их.

Запрещённые имена

По историческим причинам нельзя использовать следующие имена:

CON, PRN, AUX, NUL, COM0, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT0, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 и LPT9.

Это включает и имена с расширениями. Например, если вы назовёте файл COM1.txt, то внутри он преобразуется в \\.\COM1\ и интерпретируется самой Windows как устройство. А это не то, что нам нужно.

Чувствительность к регистру

В большинстве случаев Windows не делает различий между символами в верхнем и нижнем регистре в путях.

C:\Polish hamlet, c:\polish Hamlet, C:\Polish Hamlet и C:\POliSh hAMlET считаются абсолютно одинаковыми.

Однако с обновления Windows 10 за апрель 2018 года файловые системы NTFS имеют опцию включения чувствительности к регистру на уровне папок.

Ограничения длины

Мы ещё не закончили: ограничения есть и на длину.

Пути

Традиционно длина пути в Windows не могла превышать 260 символов. Даже сегодня это справедливо для некоторых приложений, если только их разработчики не предприняли мер для обхода этого ограничения.

Этот обход заключается в преобразовании каждого пути в литеральный путь к устройству перед передачей его Windows. Сделав это, мы сможем обойти ограничение в 260 символов и увеличить его до чуть более щедрого предела в 32767 символов.

Имена

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

Так много способов сказать одно и то же

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

• C:\CHAMELEON
• c:\chameleon
• C:\/\\//\\\///Chameleon
• C:\Windows\..\Users\..\Chameleon
• \\localhost\C$\Chameleon
• \\127.0.0.1\C$\Chameleon
• \\?\C:\Chameleon
• \\.\C:\Chameleon
• \\.\UNC\localhost\C$\Chameleon
• \\?\Volume{59e01a55-88c5-411e-bf0a-92820bdb2549}\Chameleon
• \\.\GLOBALROOT\Device\HarddiskVolume4\Chameleon
• и так далее

Вот что получаешь, когда приходится обеспечивать полную обратную совместимость в течение нескольких десятилетий!

Если эта публикация вас вдохновила и вы хотите поддержать автора — не стесняйтесь нажать на кнопку

Пути используются для поиска данных и наборов инструментов. В этом разделе представлено детальное описание путей, приведено определение видов путей и показан порядок работы с ними в ArcGIS.

D:\Data\Final\Infrastructure.gdb\EastValley\powerlines

the_path = "E:\\data\\telluride\\newdata.gdb\\slopes"

the_path = r"E:\data\telluride\newdata.gdb\slopes"

Абсолютные и относительные пути в ArcMap

При создании документа ArcMap (либо ArcScene, либо ArcGlobe) вы можете указать, что сохраняться будут относительные пути. Для установки этой опции выберите Файл > Свойства документа карты. Здесь вы можете указать, будете ли вы хранить абсолютные или относительные пути.

Картинка с сайта: desktop.arcgis.com

При сохранении документа с относительными путями приложение преобразует пути в относительные (используя точку и двойную точку) в зависимости от того, где вы сохранили документ (т.е. от текущей директории). Например, если ваш документ хранится в D:\Maps\Posters\Newmap.mxd, а данные в одном из слоев — D:\Data\Final\Infrastructure.gdb\Streets, то в Newmap.mxd будет хранится ..\..\Data\Final\Infrastructure.gdb\Streets.

Когда вы снова открываете Newmap.mxd, ArcMap преобразует сохраненные относительные пути (с обозначением с помощью точки и двух точек) обратно в абсолютные, которые отображаются как источник данных слоя. Эта конвертация всегда зависит от местоположения документа карты (текущей директории).

Преобразуются только пути, относящиеся к одному диску

Относительные пути не могут менять диски. То есть в случае, если корневой каталог находится на диске D, вы не сможете использовать относительные пути для перехода к директории на диске E. Если вы сохраняете документ карты с использованием относительных путей, преобразованы и сохранены будут только относящиеся к одному и тому же диску.

Подробнее о ссылках на данные в документе карты

Абсолютные и относительные пути в инструментах модели

Так же как и в ArcMap вы можете указывать, что в инструментах модели будут сохраняться относительные пути.

Текущая папка, используемая для относительных путей, это папка, в которой находится соответствующий набор инструментов. Опция относительного пути конвертирует и сохраняет пути к:

• Данным модели
• Растровым изображениям модели
• Используемым в модели инструментам
• Файлам, на которые ссылаются метаданные инструмента и справка
• Таблицам стилей
• Файлам слоя (.lyr), использующимся для условных обозначений
• Компилированным файлам справки (.chm)

Для сохранения относительных путей щелкните правой кнопкой мыши инструмент модели, выберите Свойства , а затем перейдите на вкладку Общие. В нижней части диалогового окна включите опцию Сохранить относительные пути, как показано ниже.

Картинка с сайта: desktop.arcgis.com

Преобразуются только пути, относящиеся к одному диску

Относительные пути не могут менять диски. То есть в случае, если корневой каталог находится на диске D, вы не сможете использовать относительные пути для перехода к директории на диске E. Если вы сохраняете вашу модель с использованием относительных путей, преобразованы и сохранены будут только пути, относящиеся к одному и тому же диску.

arcpy.AddField_management("..\redlands.gdb\streets", "ref_ID", "TEXT", 
                          field_length=10)

\\<computer name>\<shared directory>\

\\pondermatic\public\studyarea.gdb
\\omni\shared_stuff\wednesday\tools

http://www.esri.com/products.html

D:\Data\Final\Connection to ArcSDE.sde\EastValley\powerlines

По умолчанию файлы хранятся в информационной базе, но пользователь может выбрать другой способ хранения файлов — в томах на диске. Для этого в пункте «Администрирование» панели действий подсистемы «Администрирование» в разделе «Файлы» следует проставить флаг «Хранить файлы в томах на диске» и настроить том хранения файлов по гиперссылке.

Картинка с сайта: confluence.dalion.ru

При добавлении тома указывается:

• Наименование — полное наименование тома для хранения файлов;
• Код — заполняется автоматически;
• Полный путь для сервера 1С: Предприятия под управлением Microsoft Windows — напишите путь к каталогу тома для сервера под управлением Microsoft Windows в формате UNC — 
  Имя компьютера\Наименование папки\Наименование файла\;

или

• Полный путь для сервера 1С:Предприятия под управлением Linux — напишите путь к каталогу для сервера под управлением Linux;
• Порядок — введите целое число, по умолчанию равно 1. Заполнение томов осуществляется по порядку заполнения (по возрастанию) до полного заполнения тома. Эту особенность можно использовать, например, для временного отключения тома путем увеличения ему порядка заполнения.
• Предел, МБ — можно указать максимальный размер всех файлов на томе (квота тома). Если суммарный размер файлов в томе превышает установленную квоту, то будет использован следующий по порядку том. Если ни на одном из доступных томов не будет достаточно места для размещения файла, то информация об этом будет записана в журнал регистрации и будет выдано сообщение об ошибке. Если квота установлена равной нулю, то при размещении файлов в томе она не проверяется;
• Текущий размер, МБ — проставляется программой автоматически по мере наполнения тома, показывает, насколько том заполнен.

Особенности заполнения поля «Полный путь» для Linux

Если сервер 1С:Предприятия работает под Linux, то путь к тому хранения файлов можно указать только локальный, например, /home/path. Для того чтобы использовать UNC путь, нужно сделать на него ссылку. Для этого под правами администратора сделайте следующее:

• выполните команду вида mkdir folder, где вместо «folder» напишите имя своего каталога. Например, в каталоге /home выполните команду mkdir shared — будет создан каталог shared с полным путем /home/shared
• выполните команду вида mount -t cifs //server/share folder -o //domain/user, password=pwd, где — где //server/share — UNC путь к другому компьютеру , folder — путь к каталогу на Linux компьютере, например \home\shared, //domain/user — имя домена/пользователя, если необходимо, pwd — пароль пользователя (если необходимо)
• Если имя и пароль не нужны, команда выглядит так: mount -t cifs //server/share folder

После этого в пути к тому указываем folder, например, /home/shared.

По кнопке «Проверить целостность» можно сформировать отчет о целостности данных в томе. Выводится общее количество файлов и процент целостных данных.

По кнопке «Удалить лишние файлы» удаляются файлы, которые есть на диске, но сведения о них в базе отсутствуют. Предусмотрена возможность сохранить такие файлы в каталог, указав путь каталога для копирования.

В каждом томе файлы хранятся в подкаталогах. На каждую дату создания версии файла создается свой подкаталог. Все файлы хранятся с оригинальным именем и расширением, между ними добавляется номер версии, например, «Приказ.2.txt». Переход к подкаталогам файлов осуществляется через команду «Файлы в теме», расположенную на панели навигации формы. 

Работа с томами хранения файлов

При создании нового тома автоматически проверяется доступ к указанному в поле «Полный путь» каталогу, в случае ошибки выводится соответствующее сообщение. 

Заполнение томов осуществляется по порядку (по возрастанию) до полного заполнения тома. Эту особенность можно использовать для временного отключения тома путем увеличения ему порядка заполнения. 

Уже созданному тому нельзя поменять пути. 

Созданный том нельзя удалить до тех пор, пока на него ссылаются какие-либо версии файлов. 

Ошибки доступа к томам помещаются в журнал регистрации и могут быть просмотрены администратором программы. 

Для использования томов, расположенных на сетевых дисках, сервер 1С:Предприятия 8, нужно запускать от лица доменного пользователя вида domain1\user1, имеющего права доступа к тому, указанному в виде UNC пути. Этот пользователь должен входить в группу Users локального компьютера, иметь права «Run as service» и «Run as batch job» и права на каталоги, в которых сервер 1С:Предприятия 8 хранит служебные файлы — журнал регистрации, каталог временных файлов и пр.