ИМЯ¶

chown, fchown, lchown, fchownat - изменяет владельца файла

БИБЛИОТЕКА¶

Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС¶

#include <unistd.h>

int chown(const char *pathname, uid_t owner, gid_t group);
int fchown(int fd, uid_t owner, gid_t group);
int lchown(const char *pathname, uid_t owner, gid_t group);

#include <fcntl.h>           /* определения констант of AT_* */
#include <unistd.h>

int fchownat(int dirfd, const char *pathname,
             uid_t owner, gid_t group, int flags);

fchown(), lchown():

    /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L


        || _XOPEN_SOURCE >= 500


        || /* glibc <= 2.19: */ _BSD_SOURCE

fchownat():

    Начиная с glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    До glibc 2.10:


        _ATFILE_SOURCE

ОПИСАНИЕ¶

Данные системные вызовы изменяют владельца и группу для файла. Системные вызовы chown(), fchown() и lchown() отличаются только в том, каким образом задается файл:

•

chown() изменяет владельца для файла, задаваемого параметром pathname, который разыменовывается, если является символьной ссылкой.

•

fchown() изменяет владельца для файла, задаваемого открытым файловым дескриптором fd.

•

lchown() похож на chown() за исключением того, что он не разыменовывает символьные ссылки.

Только привилегированный процесс (Linux: имеющий мандат CAP_CHOWN) может сменить владельца файла. Владелец файла может сменить группу файла на любую группу, в которой он числится. Привилегированный процесс (Linux: с CAP_CHOWN) может задавать произвольную группу.

Если параметр owner или group равен -1, то соответствующий идентификатор не изменяется.

Когда владелец или группа исполняемого файла изменяется непривилегированным пользователем, то биты режима S_ISUID и S_ISGID сбрасываются В POSIX не указано, должно ли это происходить если chown() выполняется суперпользователем; поведение в Linux зависит от версии ядра и начиная с Linux 2.2.13, root рассматривается как обычный пользователь. В случае исполняемого файла вне группы (т. е., у которого не установлен бит S_IXGRP) бит S_ISGID указывает на обязательную блокировку, и не сбрасывается при выполнении chown().

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

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

При успешном выполнении возвращается 0. При ошибке возвращается -1, а в errno содержится код ошибки.

ОШИБКИ¶

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

Наиболее распространённые ошибки chown() перечислены далее.

EACCES

Поиск запрещён из-за одного из частей префикса пути (См. также path_resolution(7).)

EBADF

(fchown()) Значение fd не является правильным открытым файловым дескриптором.

EBADF

(fchownat()) pathname is relative but dirfd is neither AT_FDCWD nor a valid file descriptor.

EFAULT

Аргумент pathname указывает за пределы доступного адресного пространства.

EINVAL

(fchownat()) Указано неверное значение в flags.

EIO

(fchown()) Во время изменения индексного дескриптора (inode) возникла низкоуровневая ошибка ввода/вывода.

ELOOP

Во время определения pathname встретилось слишком много символьных ссылок.

ENAMETOOLONG

Слишком длинное значение аргумента pathname.

ENOENT

Файл не существует.

ENOMEM

Недостаточное количество памяти ядра.

ENOTDIR

Компонент в префиксе пути не является каталогом.

ENOTDIR

(fchownat()) Значение pathname содержит относительный путь и dirfd содержит файловый дескриптор, указывающий на файл, а не на каталог.

EPERM

Вызывающий процесс не имеет требуемых прав (см. выше), чтобы изменять владельца и/или группу.

EPERM

Файл помечен как неизменяемый (immutable) или только для добавления (смотрите ioctl_iflags(2)).

EROFS

Указанный файл находится на файловой системе, смонтированной только для чтения.

ВЕРСИИ¶

Версия из 4.4BSD может использоваться только суперпользователем (то есть, обычные пользователи не могут менять владельцев).

СТАНДАРТЫ¶

POSIX.1-2008.

ИСТОРИЯ¶

chown()

fchown()

lchown()

4.4BSD, SVr4, POSIX.1-2001.

fchownat()

POSIX.1-2008. Linux 2.6.16, glibc 2.4.

ПРИМЕЧАНИЯ¶

ПРИМЕРЫ¶

Следующая программа изменять владельца файла, указанного вторым в командной строке, на значение, указанное в первом аргументе командной строки. Новый владелец может задаваться в виде числового пользовательского ID, или в виде имени пользователя (которое преобразуется в пользовательский ID с помощью getpwnam(3), выполняющего поиск в системном файле паролей).

#include <pwd.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{


    char           *endptr;


    uid_t          uid;


    struct passwd  *pwd;


    if (argc != 3 || argv[1][0] == '\0') {


        fprintf(stderr, "%s <owner> <file>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    uid = strtol(argv[1], &endptr, 10);  /* Allow a numeric string */


    if (*endptr != '\0') {         /* Was not pure numeric string */


        pwd = getpwnam(argv[1]);   /* Try getting UID for username */


        if (pwd == NULL) {


            perror("getpwnam");


            exit(EXIT_FAILURE);


        }


        uid = pwd->pw_uid;


    }


    if (chown(argv[2], uid, -1) == -1) {


        perror("chown");


        exit(EXIT_FAILURE);


    }


    exit(EXIT_SUCCESS);
}

СМОТРИТЕ ТАКЖЕ¶

chgrp(1), chown(1), chmod(2), flock(2), path_resolution(7), symlink(7)

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.