cvs: phpdoc /en/reference/xattr/functions xattr-get.xml xattr-list.xml xattr-remove.xml

mg Wed Aug 18 17:24:33 2004 EDT Modified files: /phpdoc/en/reference/xattr/functions xattr-get.xml xattr-list.xml xattr-remove.xml Log: Add examples. http://cvs.php.net/diff.php/phpdoc/en/reference/xattr/functions/xattr-get.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/xattr/functions/xattr-get.xml diff -u phpdoc/en/reference/xattr/functions/xattr-get.xml:1.1 phpdoc/en/reference/xattr/functions/xattr-get.xml:1.2 --- phpdoc/en/reference/xattr/functions/xattr-get.xml:1.1 Sat Aug 14 19:39:49 2004 +++ phpdoc/en/reference/xattr/functions/xattr-get.xml Wed Aug 18 17:24:33 2004 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. --> <refentry id="function.xattr-get"> <refnamediv> @@ -46,6 +46,23 @@ <para> Returns <type>string</type> with value or &false; if attribute doesn't exist. </para> + <example> + <title><function>xattr_get</function> example</title> + <para> + The following code checks if system administrator has signed the file. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +$file = '/usr/local/sbin/some_binary; +$signature = xattr_get($file, 'Root signature', XATTR_ROOT); + +/* ... check if $signature is valid ... */ + +?> +]]> + </programlisting> + </example> <para> See also <function>xattr_set</function>, <function>xattr_remove</function>, <function>xattr_list</function>. http://cvs.php.net/diff.php/phpdoc/en/reference/xattr/functions/xattr-list.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/xattr/functions/xattr-list.xml diff -u phpdoc/en/reference/xattr/functions/xattr-list.xml:1.2 phpdoc/en/reference/xattr/functions/xattr-list.xml:1.3 --- phpdoc/en/reference/xattr/functions/xattr-list.xml:1.2 Sat Aug 14 19:46:10 2004 +++ phpdoc/en/reference/xattr/functions/xattr-list.xml Wed Aug 18 17:24:33 2004 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. --> <refentry id="function.xattr-list"> <refnamediv> @@ -45,6 +45,32 @@ <para> This function returns <type>array</type> with names of extended attributes. </para> + <example> + <title><function>xattr_list</function> example</title> + <para> + The following code prints names of all extended attributes of file. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +$file = 'some_file; +$root_attributes = xattr_list($file, XATTR_ROOT); +$user_attributes = xattr_list($file); + +echo "Root attributes: \n"; +foreach ($root_attributes as $attr_name) { + printf("%s\n", $attr_name); +} + +echo "\n User attributes: \n"; +foreach ($attributes as $attr_name) { + printf("%s\n", $attr_name); +} + +?> +]]> + </programlisting> + </example> <para> See also <function>xattr_get</function>, <function>xattr_set</function>, <function>xattr_remove</function>. http://cvs.php.net/diff.php/phpdoc/en/reference/xattr/functions/xattr-remove.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/xattr/functions/xattr-remove.xml diff -u phpdoc/en/reference/xattr/functions/xattr-remove.xml:1.1 phpdoc/en/reference/xattr/functions/xattr-remove.xml:1.2 --- phpdoc/en/reference/xattr/functions/xattr-remove.xml:1.1 Sat Aug 14 19:39:49 2004 +++ phpdoc/en/reference/xattr/functions/xattr-remove.xml Wed Aug 18 17:24:33 2004 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. --> <refentry id="function.xattr-remove"> <refnamediv> @@ -46,6 +46,24 @@ <para> &return.success; </para> + <example> + <title><function>xattr_remove</function> example</title> + <para> + The following code removes all extended attributes of file. + </para> + <programlisting role="php"> +<![CDATA[ +<?php +$file = 'some_file; +$attributes = xattr_list($file); + +foreach ($attributes as $attr_name) { + xattr_remove($file, $attr_name); +} +?> +]]> + </programlisting> + </example> <para> See also <function>xattr_get</function>, <function>xattr_set</function>, <function>xattr_list</function>.