Edit Report a Bug

    dio_fcntl

    (PHP 4 >= 4.2.0, PHP 5 < 5.1.0)

    dio_fcntl — Exécute une fonction fichier de langage C

    Description

    dio_fcntl(resource $fd, int $cmd, mixed $args = ?): mixed

    dio_fcntl() exécute l'opération cmd sur le fichier représenté par la ressource fd. Certaines commandes demandent des arguments supplémentaires qui sont fournis dans l'argument args.

    Liste de paramètres

    fd

    La ressource de fichier retournée par dio_open().

    cmd

    Peut être une de ces opérations suivantes :

    • F_SETLK : le verrou est posé ou levé. Si le verrou appartient à un autre utilisateur, dio_fcntl() retourne -1.

    • F_SETLKW : identique à F_SETLK, mais si le verrou appartient à quelqu'un d'autre, dio_fcntl() attend la levée du verrou.

    • F_GETLK : dio_fcntl() retourne un tableau associatif (comme décrit ci-dessous) si un autre utilisateur empêche la poste d'un verrou. S'il n'y a aucun empêchement, l'entrée "type" prendra la valeur F_UNLCK.

    • F_DUPFD : trouve les numéros de ressource de fichier les plus petits, disponibles, inférieurs ou égales à args et les retourne.

    • F_SETFL : configure les descripteurs de fichier à la valeur spécifiée par args, qui peut être O_APPEND, O_NONBLOCK ou O_ASYNC. Pour utiliser O_ASYNC vous aurez besoin de l'extension PCNTL.

    args

    args est un tableau associatif lorsque cmd vaut F_SETLK ou F_SETLLW, avec les entrées suivantes :

    • start : offset de début de verrou

    • length : taille de la surface verrouillée. Zéro indique la fin du fichier

    • whence : l_start est relatif à : peut être SEEK_SET, SEEK_END et SEEK_CUR

    • type : type de verrou. peut être F_RDLCK (verrou en lecture), F_WRLCK (verrou en écriture) ou F_UNLCK (déverrouillage)

    Valeurs de retour

    Retourne le résultat d'un appel en C.

    Exemples

    Exemple #1 Positionnement et suppression d'un verrou

    <?php

    $fd     = dio_open('/dev/ttyS0', O_RDWR);

    if (    dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) {
    // le descripteur de fichier semble verrouillé
    echo "Le verrou n'a pu être effacé. Il a été posé par quelqu'un d'autre.";
    } else {
    echo     "Le verrou a été défini/verrouillé avec succès";
    }

    dio_close($fd);
    ?>

    Notes

    Note: Cette fonction n'est pas implémentée sur les plates-formes Windows.

    add a note add a note

    User Contributed Notes 1 note

    up
    -8
    Guillermo Prandi
    11 years ago
    Actually, there's a small typo in the above docs. The parameter for where l_start is relative to is actually "whence" and not "wenth" like stated.
    add a note add a note
    To Top