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

#include <sys/stat.h.h>

Fonction chmod

int chmod( const char * path, mode_t mode );

Cette fonction permet de changer les droits d'accès du fichier spécifié en paramètre (chmod = 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 = chmod( "filename", 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 = chmod( "filename", 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

• path : ce paramètre permet d'indiquer le chemin du 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.
• EFAULT : le pointeur path spécifié en paramètre pointe en dehors de l'espace d'adressage autorisé.
• EIO : une erreur d'entrée/sortie s'est produite.
• ELOOP : le chemin spécifié contient une référence circulaire, certainement au travers d'un lien symbolique.
• ENAMETOOLONG : le chemin spécifié dépasse PATH_MAX caractères, ou l'un de ses éléments constitutifs dépasse NAME_MAX.
• ENOENT : le chemin spécifié n'existe pas.
• ENOMEM : il n'y a plus assez de mémoire pour le noyau.
• 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 

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

#include <sys/stat.h>   // chmod

#define FILE_NAME "demo.txt"

int main() {

    // Création d'un fichier de démonstration
    FILE * file = fopen( FILE_NAME, "w" );
    if ( file == NULL  ) {
        fprintf( stderr, "Impossible de créer le fichier de démonstration\n" );
        exit( EXIT_FAILURE );
    }
    fprintf( file, "Ok\n" );
    fclose( file );
    
    // On change à plusieurs reprises les droits d'accès et on les affiche.
    int result = chmod( FILE_NAME, 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);
    
    chmod( FILE_NAME, 0640 );
    system(buffer);

    chmod( FILE_NAME, 0644 );
    system(buffer);
    
    chmod( FILE_NAME, 0755 );
    system(buffer);
    
    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