Книга: Разработка приложений в среде Linux. Второе издание

14.1.1. Поиск текущего рабочего каталога

14.1.1. Поиск текущего рабочего каталога

Функция getcwd() позволяет процессу найти имя своего текущего каталога относительно корневого каталога системы.

#include <unistd.h>
char * getcwd(char * buf, size_t size);

Первый параметр, buf, указывает на буфер, хранящий путь к текущему каталогу. Если длина текущего пути превышает size - 1 байт (-1 позволяет пути завершаться символом ''), функция возвращает ошибку ЕRANGE. Если вызов удается, возвращается buf; в случае ошибки возвращается NULL. Несмотря на то что в большинстве современных оболочек поддерживается переменная окружения PWD, хранящая путь в текущий каталог, ее значение необязательно равняется значению, возвращаемому getcwd(). PWD часто содержит элементы путей, являющиеся символическими ссылками на другие каталоги, но getcwd() всегда возвращает путь, свободный от символических ссылок.

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

char * buf;
int len = 50;
buf = malloc(len);
while (!getcwd(buf, len) && errno == ERANGE) {
 len += 50;
 buf = realloc(buf, len);
}

Как и многие другие Unix-подобные системы, Linux предоставляет полезное расширение POSIX-спецификации getcwd(). Если buf является NULL, функция распределяет буфер, размер которого достаточен для содержания текущего пути, с помощью нормального механизма malloc(). Несмотря на то что вызывающий код должен позаботиться о надлежащем освобождении памяти, используемой результатом, это расширение обеспечивает лучшую очистку, нежели цикл, как показано в предыдущем примере.

Функция BSD по имени getwd() является наиболее распространенной альтернативой getcwd(), но ее определенные дефекты привели к разработке getcwd().

#include <unistd.h>
char * getwd(char * buf);

Как и getcwd(), getwd() заполняет buf текущим путем, хотя функция не имеет представления о размере buf. getwd() никогда не записывает в буфер больше, чем PATH_MAX (определенная в <limits.h>), что позволяет программам избегать переполнения буферов, но не предоставляет программе механизма поиска правильного пути, если он превышает PATH_MAX байт[100]. Эта функция поддерживается Linux только для унаследованных приложений и не может использоваться новыми приложениями. Вместо этого применяйте правильную и более переносимую функцию getcwd().

Если для пользователей необходимо отображать текущий путь каталога, хорошим решением будет проверка переменной окружения PWD. Если она установлена, она содержит путь, который применяется пользователем и который может содержать символические ссылки на некоторые элементы пути. Этот путь обычно и должен отображаться приложением по желанию пользователя. Для облегчения задачи библиотека С в Linux предоставляет функцию get_current_dir_name(), реализуемую следующим образом.

char * get_current_dir_name() {
char * env = getenv("PWD");
if (env)
 return strdup(env);
else
 return getcwd(NULL, 0);
}

Оглавление книги