DESCRIPTION.

Retourne certaines informations sur le système de fichier contenant le fichier associé à un descripteur de fichier donné.

SYNTAXE.

TPL_Valeurs = os.statvfs ( fichier )

TPL_Valeurs = ⇨ variable qui recevra la valeur retournée [ optionnel ]

os.statvfs ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

fichier ⇨ nom du fichier [ OBLIGATOIRE ]

REMARQUES.

fichier doit être un : 

- str ( ), ou un bytes ( ), indiquant le chemin absolu, ou relatif, d'un fichier présent sur l'un des supports de masse disponibles ; 

- int ( ) correspondant au descripteur d'un fichier actuellement ouvert.

La méthode os.statvfs ( ) n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

l'appel de la méthode os.statvfs ( ) retourne un objet de type statvfs_result, assimilable à un tuple ( ) à champs nommés, avec les attributs, et leur valeur actuelle, décrivant le système de fichier contenant le fichier, ou son descripteur, donné en paramètre. Ces attributs sont : 

- f_bavail, nombre de blocs libres pour non-root ;

- f_bfree, nombre de blocs libres ;

- f_blocks, taille du système de fichiers en unité f_frsize ;

- f_bsize, taille de bloc du système de fichiers ;

- f_favail, nombre d'inœuds (inode) libres pour non-root ;

- f_ffree, nombre d'inœuds (inode)libres ;

- f_files, nombre d'inœuds (inode) ;

- f_flag, attributs de montage ;

- f_frsize, taille des fragments ;

- f_fsid, identifiant du système de fichiers ;

- f_namemax, longueur maximum de nom de fichier.

Deux constantes de module sont définies pour le champ-de-bits de l'attribut f_flag si : 

- SR_RDONLY est activé, le système de fichiers est monté en lecture-seule ; 

- ST_NOSUID est activé, la sémantique des bits de setuid / getuid est désactivée ou non gérée. 

Des constantes de module supplémentaires sont définies pour les systèmes basés sur GNU/glibc.

- ST_NODEV, interdit l'accès aux fichiers spéciaux du périphérique ; 

- ST_NOEXEC, interdit l'exécution de programmes ; 

- ST_SYNCHRONOUS, les écritures sont synchronisées en une fois ; 

- ST_MANDLOCK, permet les verrous impératifs sur un système de fichiers ; 

- ST_WRITE, écrit sur les fichiers/répertoires/liens symboliques ; 

- ST_APPEND, fichiers en ajout-seul ; 

- ST_IMMUTABLE, fichiers immuables ; 

- ST_NOATIME, ne met pas à jour les moments d'accès ; 

- ST_NODIRATIME, ne met pas à jour les moments d'accès aux répertoires ; 

- ST_REALTIME, Met atime à jour relativement à mtime / ctime). (cf.: docs Python).

EXEMPLE.

import os

print ( os.statvfs ( os.getcwd ( ) ) )

print ( )

print ( "f_blocks :" , os.statvfs ( os.getcwd ( ) ).f_blocks )

print ( "f_ffree :" , os.statvfs ( os.getcwd ( ) ).f_ffree )

print ( )

kclefs = [ "f_bsize" , "f_frsize" , "f_blocks" , "f_bfree" , "f_bavail" , "f_files" , "f_ffree" , "f_favail" , "f_flag" , "f_namemax" , "f_fsid" ]

kvaleurs = [ kelement for kelement in os.statvfs ( os.getcwd ( ) ) ]

kfusion = dict ( zip ( kclefs , kvaleurs ) )

for kcle , kvaleur in kfusion.items ( ) : print ( kcle , ":" , kvaleur )