Add fsync & fdatasync translation + review stat (#255)

Co-authored-by: prudhomme victor <vic301202@gmail.com>
This commit is contained in:
Victor
2022-07-06 18:17:22 +02:00
committed by GitHub
parent bc46b17057
commit 6c8ac3d834
3 changed files with 192 additions and 2 deletions

View File

@@ -0,0 +1,96 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: victor-prdh Status: ready -->
<refentry xml:id="function.fdatasync" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fdatasync</refname>
<refpurpose>Synchronise les données (mais pas les métadonnées) avec le fichier</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>fdatasync</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction synchronise le contenu du <parameter>stream</parameter> sur le support de stockage, tout comme <function>fsync</function> le fait,
mais elle ne synchronise pas les métadonnées des fichiers.
Il est à noter que que cette fonction est différente seulement dans les systèmes POSIX.
Sous Windows, cette fonction est un alias de <function>fsync</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>stream</parameter></term>
<listitem>
&fs.validfp.all;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>fdatasync</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$file = 'test.txt';
$stream = fopen($file, 'w');
fwrite($stream, 'test data');
fwrite($stream, "\r\n");
fwrite($stream, 'additional data');
fdatasync($stream);
fclose($stream);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>fflush</function></member>
<member><function>fsync</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,94 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: victor-prdh Status: ready -->
<refentry xml:id="function.fsync" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fsync</refname>
<refpurpose>Synchronise les modifications apportées au fichier (y compris les métadonnées)</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>fsync</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction synchronise les modifications apportées au fichier, y compris ses métadonnées. Celle-ci est similaire à <function>fflush</function>,
mais elle demande également au système d'exploitation d'écrire sur le support de stockage.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>stream</parameter></term>
<listitem>
&fs.validfp.all;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>fsync</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$file = 'test.txt';
$stream = fopen($file, 'w');
fwrite($stream, 'test data');
fwrite($stream, "\r\n");
fwrite($stream, 'additional data');
fsync($stream);
fclose($stream);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>fdatasync</function></member>
<member><function>fflush</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -148,7 +148,7 @@
<para>
**** - Sous Windows, depuis PHP 7.4.0, c'est l'identifiant associé avec le fichier,
qui sera un entier 64-bit <emphasis>non signé</emphasis> qui peut déborder.
Previously, it was always <literal>0</literal>.
Auparavant, c'était toujours <literal>0</literal>.
</para>
<para>
***** Sous Windows, le bit de la permission d'écriture est définit en
@@ -245,7 +245,7 @@
Les valeurs statiques <literal>size</literal>, <literal>atime</literal>,
<literal>mtime</literal> et <literal>ctime</literal> des liens symboliques
sont toujours ceux de la cible. Ce n'était précédemment pas le cas
This was previously not the case for <abbrev>NTS</abbrev> builds on Windows.
pour les builds <abbrev>NTS</abbrev> sous Windows.
</entry>
</row>
</tbody>