Fonction fchmod - Entête <sys/stat.h>

#include <sys/stat.h.h>

Fonction fchmod

int fchmod( int fileDescriptor, mode_t mode );

Cette fonction permet de changer les droits d'accès du fichier associé au descripteur de fichier passé en paramètre (fchmod = file change mode).

La gestion des droits Unix/Linux étant basée sur une représentation en base octale, je vous recommande conserver cette façon de faire pour spécifier les nouveaux droits d'accès de votre fichier (ou de votre dossier).

 1 

int result = fchmod( fd, 0755 );   // -rwxr-xr-x

Pour autant, il est aussi possible de spécifier les droits d'accès via un masque binaire et un jeu de constantes proposé par l'entête <sys/stat.h>. Voici un exemple d'utilisation de cette possibilité.

 1 
 2 

mode_t rights = S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP | IROTH | IXOTH; 
int result = fchmod( fd, rights );   // -rwxr-xr-x

Le tableau suivant présente les constantes relatives aux droits d'accès sur un fichier (ou un dossier).

Paramètres

• fileDescriptor : le descripteur de fichier (ou dossier) sur lequel changer les droits d'accès.
• mode : les nouveaux droits d'accès du fichier.

Valeur de retour

Si le changement de droits se passe bien, la fonction renvoie la valeur 0. Dans le cas contraire, la valeur -1 vous sera retournée et la variable errno sera fixée avec le code erreur constaté.

Codes erreurs pouvant être retournés

• EACCES : vous n'avez pas les droits nécessaires pour accéder au fichier.
• EBADF : le descripteur de fichier est illégale.
• ENOTDIR : un des éléments du chemin spécifié n'est pas un dossier.
• EPERM : l'identifiant utilisateur (UID) effectif ne correspond pas au propriétaire du fichier, et le processus n'est pas privilégié (sous Linux : il n'a pas la capacité CAP_FOWNER).
• EROFS : vous tentez de changer les droits d'accès sur un système de fichiers « Read Only »

Exemple de code

Voici un exemple de code qui modifie les droits d'accès sur un fichier.

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 
 32 
 33 
 34 
 35 
 36 
 37 
 38 
 39 
 40 
 41 
 42 
 43 
 44 
 45 
 46 
 47 
 48 
 49 
 50 
 51 
 52 

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <fcntl.h>      // O_WRONLY, O_CREAT
#include <sys/stat.h>   // fchmod
#include <unistd.h>     // open, write, close

#define FILE_NAME "demo.txt"

int main() {

    // Création d'un fichier de démonstration
    int fd = open( FILE_NAME, O_WRONLY | O_CREAT, 0644 );
    if ( fd < 0  ) {
        fprintf( stderr, "Impossible de créer le fichier de démonstration\n" );
        exit( EXIT_FAILURE );
    }
    write( fd, "ok\n", 3 );
    
    
    // On change à plusieurs reprises les droits d'accès et on les affiche.
    int result = fchmod( fd, 0600 );
    if ( result != EXIT_SUCCESS ) {
        switch( errno ) {
            case EACCES:
                fprintf( stderr, "Tu n'as pas les autorisations nécessaires\n" );
                break;
            default:
                fprintf( stderr, "Ca ne marche pas et je ne t'en dirais pas plus ;-)\n" );
        }
        exit( EXIT_FAILURE );
    }
    char buffer[20];
    strcat(strcpy(buffer, "ls -l "), FILE_NAME);
    system(buffer);
    
    fchmod( fd, 0640 );
    system(buffer);

    fchmod( fd, 0644 );
    system(buffer);
    
    fchmod( fd, 0755 );
    system(buffer);

    // On ferme le fichier
    close( fd );

    return EXIT_SUCCESS;
}

Et voici les résultats produits par cet exemple de code.

$> gcc -o sample sample.c
$> ./sample
-rw-------. 1 dominique dominique 3  4 janv. 10:49 demo.txt
-rw-r-----. 1 dominique dominique 3  4 janv. 10:49 demo.txt
-rw-r--r--. 1 dominique dominique 3  4 janv. 10:49 demo.txt
-rwxr-xr-x. 1 dominique dominique 3  4 janv. 10:49 demo.txt
$> 

Conformité

POSIX 88 (IEEE Std 1003.1-1988) et versions ultérieures.

Sujets connexes