[PHP-DOC] cvs: phpdoc /it/functions crack.xml

[Luca Perugini]

perugini                Tue Mar  5 05:19:23 2002 EDT

  Added files:                 
    /phpdoc/it/functions        crack.xml 
  Log:
  Translated by Gabriele Scaroni
  
  

Index: phpdoc/it/functions/crack.xml
+++ phpdoc/it/functions/crack.xml
<?xml version="1.0" encoding="iso-8859-1"?>
 <!-- EN-Revision: 1.7 Maintainer: scaro  Status: ready -->
 <reference id="ref.crack">
  <title>Funzioni di Crack</title>
  <titleabbrev>Crack</titleabbrev>

  <partintro>
   <simpara>
    Queste funzioni permettono di usare la libreria CrackLib per testare la 'forza'
    di una password. Per utilizzare queste funzioni, bisogna compilare il PHP con
    il supporto Crack usando l'opzione <option 
role="configure">--with-crack[=DIR]</option>.
   </simpara>
   <simpara>
    Maggiori informazioni riguardo CrackLib possono essere trovate, insieme alla 
libreria, a
    <ulink url="&url.crack;">&url.crack;</ulink>.
   </simpara>
   <simpara>
    Cracklib &egrave; utile per testare la 'forza' di una password perch&egrave; 
controlla la
    lunghezza, l'uso di maiuscole e minuscole ed effettua un controllo nel dizionario
    specificato. CrackLib dar&agrave; anche utili messaggi diagnostici che aiuteranno 
nel
    'rafforzare' la password.
    </simpara>
    <para>
     Questo esempio mostra come aprire un dizionario di CrackLib, testare una 
determinata password,
     recuperare tutti i messaggi diagnostici, e chiudere il dizionario.
     <example>
      <title>Esempio di CrackLib</title>
       <programlisting role="php">
<![CDATA[
<?php
// Apre il dizionario di CrackLib
$dizionario = crack_opendict('/usr/local/lib/pw_dict')
     or die('Incapace di aprire il dizionario di CrackLib');

// Esegue il controllo della password
$controllo = controllo_crack($dizionario, 'gx9A2s0x');

// Recupera i messaggi
$messaggio = crack_getlastmessage();
echo $messaggio; // 'password forte'

// Chiude il dizionario
crack_closedict($dizionario);
?>
]]>
       </programlisting>
     </example>
    </para>
    <note>
     <para>
      Se <function>crack_check</function> restituisce &true;,
      <function>crack_getlastmessage</function> restituir&agrave; 'password forte'.
     </para>
    </note>
  </partintro>


  <refentry id="function.crack-opendict">
   <refnamediv>
    <refname>crack_opendict</refname>
    <refpurpose>Apre un nuovo dizionario di CrackLib</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>resource</type><methodname>crack_opendict</methodname>
       <methodparam><type>string</type><parameter>dizionario</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce un identificatore di risorsa dizionario in caso di successo, o
     &false; in caso di fallimento.
    </para>
     &warn.experimental.func;
    <para>
     <function>crack_opendict</function> apre il
     <parameter>dizionario</parameter> specificato di CrackLib per usarlo con
     <function>crack_check</function>.
    </para>
    <note>
     <para>
      Pu&ograve; essere aperto solo un dizionario alla volta.
     </para>
    </note>
    <para>
     Vedere anche: <function>crack_check</function>, e
     <function>crack_closedict</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.crack-closedict">
   <refnamediv>
    <refname>crack_closedict</refname>
    <refpurpose>Chiude un dizionario di CrackLib aperto </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>bool</type><methodname>crack_closedict</methodname>
      <methodparam 
choice="opt"><type>resource</type><parameter>dizionario</parameter></methodparam>
     </methodsynopsis>
    <para>
     &return.success;
    </para>
     &warn.experimental.func;
    <para>
     <function>crack_closedict</function> chiude l'identificatore del
     <parameter>dizionario</parameter> specificato.  Se
     <parameter>dizionario</parameter> non &egrave; specificato, verr&agrave;
     chiuso il dizionario corrente.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.crack-check">
   <refnamediv>
    <refname>crack_check</refname>
    <refpurpose>Effettua un controllo nascosto con la password data</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>bool</type><methodname>crack_check</methodname>
      <methodparam 
choice="opt"><type>resource</type><parameter>dizionario</parameter></methodparam>
      <methodparam><type>string</type><parameter>password</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce &true; se <parameter>password</parameter> � forte, altrimenti &false;.
    </para>
     &warn.experimental.func;
    <para>
     <function>crack_check</function> effettua un controllo nascosto della
     <parameter>password</parameter> data nel <parameter>dizionario</parameter>
     specificato. Se <parameter>dizionario</parameter> non &egrave; specificato
     viene utilizzato l'ultimo dizionario aperto.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.crack-getlastmessage">
   <refnamediv>
    <refname>crack_getlastmessage</refname>
    <refpurpose>Restituisce il messaggio dell'ultimo controllo nascosto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>crack_getlastmessage</methodname>
      <void/>
     </methodsynopsis>
     &warn.experimental.func;
    <para>
     <function>crack_getlastmessage</function> restituisce il messaggio dell'ultimo
     controllo nascosto.
    </para>
   </refsect1>
  </refentry>

 </reference>

 <!-- 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:"../../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
 -->