Diff of autodoc.git/traditional.xml (5114a8567b89eb56cf441d370cdd0e0b2eb6151d » d83d3c65798545ad37db79756329b29b71443893)

autodoc.git/traditional.xml:1: <?xml version='1.0' encoding='utf-8'?> - <manual time-stamp='2019-03-09' version='Pike v8.1.13'> + <manual time-stamp='2019-03-19' version='Pike v8.1.13'> <dir name='./traditional_manual'> <file name='./traditional_manual/index.html'> <chapter title='Table of Contents' unnumbered='1'> <dl><dt><url href='index.html'>Table of Contents</url></dt> <dt><url href='chapter_1.html'>1. Introduction</url></dt> <dd><url href='chapter_1.html#1'>1.1. Overview</url></dd> <dd><url href='chapter_1.html#2'>1.2. The history of Pike</url></dd> <dd><url href='chapter_1.html#3'>1.3. A comparison with other languages</url></dd> <dd><url href='chapter_1.html#4'>1.4. What is Pike</url></dd> <dd><url href='chapter_1.html#5'>1.5. Pike License</url></dd>
autodoc.git/traditional.xml:129023: public keys must be set. </text></group><group><param name='name'/><text>The distinguished name for the certificate. </text></group><group><param name='attributes'/><text>Attributes from PKCS #9 to add to the certificate. </text></group><group><param name='hash'/><text>Hash algoritm to use for the CSR signature. Defaults to <ref resolved='predef::Crypto.SHA256'>Crypto.SHA256</ref>. </text></group><group><note/><text>Prior to Pike 8.0 this function only supported signing with <ref resolved='predef::Crypto.RSA'>Crypto.RSA</ref> and the default (and only) hash was <ref resolved='predef::Crypto.MD5'>Crypto.MD5</ref>. </text></group></doc> <method name='build_csr'> - <arguments><argument name='sign'><type><object resolved='predef::Crypto.Sign'>Crypto.Sign</object></type></argument><argument name='name'><type><object resolved='predef::Standards.ASN1.Types.Sequence'>Sequence</object></type></argument><argument name='attributes'><type><mapping><indextype><string/></indextype><valuetype><array><valuetype><object resolved='predef::Object'>Object</object></valuetype></array></valuetype></mapping></type></argument><argument name='hash'><type><or><object resolved='predef::Crypto.Hash'>Crypto.Hash</object><void/></or></type></argument></arguments> + <arguments><argument name='sign'><type><object resolved='predef::Crypto.Sign'>Crypto.Sign</object></type></argument><argument name='name'><type><object resolved='predef::Standards.ASN1.Types.Sequence'>Sequence</object></type></argument><argument name='attributes'><type><mapping><indextype><string/></indextype><valuetype><array><valuetype><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></valuetype></array></valuetype></mapping></type></argument><argument name='hash'><type><or><object resolved='predef::Crypto.Hash'>Crypto.Hash</object><void/></or></type></argument></arguments> <returntype><object resolved='predef::Standards.ASN1.Types.Sequence'>Sequence</object></returntype> </method> </docgroup> <docgroup homogen-name='' homogen-type='import'> <import name=''><classname resolved='predef::'>predef::</classname></import> </docgroup> <docgroup homogen-name='Types' homogen-type='import'> <import name='Types'><classname resolved='predef::Standards.ASN1.Types'>Standards.ASN1.Types</classname></import> </docgroup> <docgroup homogen-name='sign_cri' homogen-type='method'><doc><text>Sign a <ref resolved='predef::Standards.PKCS.CSR.CRI'>CRI</ref> to generate a Certificate Signing Request.
autodoc.git/traditional.xml:129473: Setting The signature. </text></doc> <variable name='signature'><type><object resolved='predef::Standards.ASN1.Types.BitString'>BitString</object></type></variable> </docgroup> <docgroup homogen-name='tbs' homogen-type='variable'><doc><text>Getting ASN.1 structure that has been signed. Setting ASN.1 structure that has been signed. </text></doc> - <variable name='tbs'><type><object resolved='predef::Object'>Object</object></type></variable> + <variable name='tbs'><type><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></type></variable> </docgroup> </class> </module> </module> <module name='TLD'> <docgroup homogen-name='cc' homogen-type='constant'><doc><text>A mapping between country TLDs and the name of the country. </text></doc> <constant name='cc'/> </docgroup> <docgroup homogen-name='generic' homogen-type='variable'><doc><text>A multiset containing the generic TLDs, such as "com" and "info".
autodoc.git/traditional.xml:129985: <method name='load_authorities'> <arguments><argument name='root_cert_dirs'><type><or><string/><array><valuetype><string/></valuetype></array><void/></or></type></argument><argument name='cache'><type><or><int><min>0</min><max>1</max></int><void/></or></type></argument></arguments> <returntype><mapping><indextype><string/></indextype><valuetype><array><valuetype><object resolved='predef::Standards.X509.Verifier'>Verifier</object></valuetype></array></valuetype></mapping></returntype> </method> </docgroup> <docgroup homogen-name='make_extension' homogen-type='method'><doc><text>Creates a certificate extension with the <ref resolved='predef::Standards.X509.make_extension.id'>id</ref> as identifier and <ref resolved='predef::Standards.X509.make_extension.ext'>ext</ref> as the extension payload. If the <ref resolved='predef::Standards.X509.make_extension.critical'>critical</ref> flag is set the extension will be marked as critical. </text></doc> <method name='make_extension'> - <arguments><argument name='id'><type><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></type></argument><argument name='ext'><type><object resolved='predef::Object'>Object</object></type></argument><argument name='critical'><type><or><void/><int/></or></type></argument></arguments> + <arguments><argument name='id'><type><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></type></argument><argument name='ext'><type><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></type></argument><argument name='critical'><type><or><void/><int/></or></type></argument></arguments> <returntype><object resolved='predef::Standards.ASN1.Types.Sequence'>Sequence</object></returntype> </method> </docgroup> <docgroup homogen-name='make_selfsigned_certificate' homogen-type='method'><doc><text>Creates a selfsigned certificate, i.e. where issuer and subject are the same entity. This entity is derived from the list of pairs in <ref resolved='predef::Standards.X509.make_selfsigned_certificate.name'>name</ref>, which is encoded into an distinguished_name by <ref resolved='predef::Standards.PKCS.Certificate.build_distinguished_name'>Standards.PKCS.Certificate.build_distinguished_name</ref>. </text><group><param name='c'/><text>The public key cipher used for the certificate, <ref resolved='predef::Crypto.RSA'>Crypto.RSA</ref>, <ref resolved='predef::Crypto.DSA'>Crypto.DSA</ref> or <ref resolved='predef::Crypto.ECC.Curve.ECDSA'>Crypto.ECC.Curve.ECDSA</ref>. The object should be initialized with both public and private keys.
autodoc.git/traditional.xml:130269: </docgroup> <docgroup homogen-name='ext_subjectKeyIdentifier' homogen-type='variable'><doc><text>Set to the value of the SubjectKeyIdentifier if the certificate contains the subjectKeyIdentifier extension. <rfc>3280:4.2.1.2</rfc>. </text></doc> <variable name='ext_subjectKeyIdentifier'><type><string/></type></variable> </docgroup> <docgroup homogen-name='extensions' homogen-type='variable'><doc><group><note/><text>optional </text></group><group><note/><text>Read only </text></group></doc> - <variable name='extensions'><type><mapping><indextype><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></indextype><valuetype><object resolved='predef::Object'>Object</object></valuetype></mapping></type></variable> + <variable name='extensions'><type><mapping><indextype><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></indextype><valuetype><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></valuetype></mapping></type></variable> </docgroup> <docgroup homogen-name='hash' homogen-type='variable'><doc><text>Algorithm hash if known and supported. Otherwise <ref resolved='predef::.UNDEFINED'>UNDEFINED</ref>. </text><group><note/><text>Read only </text></group></doc> <variable name='hash'><type><object resolved='predef::Crypto.Hash'>Crypto.Hash</object></type></variable> </docgroup> <docgroup homogen-name='Sequence' homogen-type='inherit'> <inherit name='Sequence'><classname resolved='predef::Standards.ASN1.Types.Sequence'>Sequence</classname></inherit> </docgroup> <docgroup homogen-name='init' homogen-type='method'><doc><text>Populates the object from a certificate decoded into an ASN.1 Object. Returns the object on success, otherwise <expr>0</expr>. You probably want to call <ref resolved='predef::Standards.X509.decode_certificate'>decode_certificate</ref> or even <ref resolved='predef::Standards.X509.verify_certificate'>verify_certificate</ref>. </text></doc> <method name='init'> - <arguments><argument name='asn1'><type><or><array/><object resolved='predef::Object'>Object</object></or></type></argument></arguments> + <arguments><argument name='asn1'><type><or><array/><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></or></type></argument></arguments> <returntype><object resolved='predef::Standards.X509.TBSCertificate'>this_program</object></returntype> </method> </docgroup> <docgroup homogen-name='internal_critical' homogen-type='variable'><doc><group><note/><text>optional </text></group></doc> <variable name='internal_critical'><modifiers><protected/></modifiers><type><multiset/></type></variable> </docgroup> <docgroup homogen-name='internal_extensions' homogen-type='variable'><doc><group><note/><text>optional </text></group></doc> - <variable name='internal_extensions'><modifiers><protected/></modifiers><type><mapping><indextype><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></indextype><valuetype><object resolved='predef::Object'>Object</object></valuetype></mapping></type></variable> + <variable name='internal_extensions'><modifiers><protected/></modifiers><type><mapping><indextype><object resolved='predef::Standards.ASN1.Types.Identifier'>Identifier</object></indextype><valuetype><object resolved='predef::Standards.ASN1.Types.Object'>Object</object></valuetype></mapping></type></variable> </docgroup> <docgroup homogen-name='issuer' homogen-type='variable'><doc><text>Certificate issuer. </text></doc> <variable name='issuer'><type><void/></type></variable> </docgroup> <docgroup homogen-name='issuer_id' homogen-type='variable'><doc><group><note/><text>optional </text></group></doc> <variable name='issuer_id'><type><void/></type></variable> </docgroup> <docgroup homogen-name='keyinfo' homogen-type='variable'>
autodoc.git/traditional.xml:132600: <arguments><argument name='mutex_key'><type><object resolved='predef::Thread.MutexKey'>Thread.MutexKey</object></type></argument><argument name='seconds'><type><or><int><min>0</min><max/></int><float/></or></type></argument></arguments> <returntype><void/></returntype> </method> <method name='wait'> <arguments><argument name='mutex_key'><type><object resolved='predef::Thread.MutexKey'>Thread.MutexKey</object></type></argument><argument name='seconds'><type><int><min>0</min><max/></int></type></argument><argument name='nanos'><type><int><min>0</min><max>999999999</max></int></type></argument></arguments> <returntype><void/></returntype> </method> </docgroup> </class> <class name='Farm'> - <modifiers><optional/></modifiers> + <doc><text>A thread farm. </text></doc> <docgroup homogen-name='debug_status' homogen-type='method'><doc><text>Get some statistics for the thread farm. </text></doc> <method name='debug_status'> <arguments/> <returntype><string/></returntype> </method> </docgroup> <docgroup homogen-name='run' homogen-type='method'><doc><text>Register a job for the thread farm.
autodoc.git/traditional.xml:132714: <docgroup homogen-name='debug_status' homogen-type='method'><doc><text>Get some statistics about the worker thread. </text></doc> <method name='debug_status'> <arguments/> <returntype><string/></returntype> </method> </docgroup> </class> <class name='Result'> <doc><text>An asynchronous result. - </text></doc> + </text><group><fixme/><text>This class ought to be made <ref resolved='predef::Concurrent.Future'>Concurrent.Future</ref>-compatible. + </text></group></doc> <docgroup homogen-name='`()' homogen-type='method'><doc><text>Wait for completion. </text></doc> <method name='`()'> <arguments/> <returntype><mixed/></returntype> </method> </docgroup> <docgroup homogen-name='provide' homogen-type='method'><doc><text>Register a completed result. </text><group><param name='what'/><text>The result to register. </text></group></doc>
autodoc.git/traditional.xml:132771: arrived yet. </text></group><group><value>-1</value><text>Returns negative on failure. </text></group></int> </text></group></doc> <method name='status'> <arguments/> <returntype><int/></returntype> </method> </docgroup> </class> + <class name='ResultWrapper'> + <modifiers><protected/></modifiers> + <doc><text>A wrapper for an asynchronous result. + </text><group><note/><text>This wrapper is used to detect when the + user discards the values returned from + <ref resolved='predef::Thread.Farm.run'>run()</ref> or <ref resolved='predef::Thread.Farm.run_multiple'>run_multiple()</ref>, so that + any errors thrown aren't lost. + </text></group></doc> + <docgroup homogen-name='`()' homogen-type='method'><doc><text>Wait for completion. + </text></doc> + <method name='`()'> + <arguments/> + <returntype><mixed/></returntype> + </method> + </docgroup> + <docgroup homogen-name='create' homogen-type='method'> + <method name='create'><modifiers><protected/></modifiers> + <arguments><argument name='ro'><type><object resolved='predef::Thread.Farm.Result'>Result</object></type></argument></arguments> + <returntype><void/></returntype> + </method> + </docgroup> + <docgroup homogen-name='provide' homogen-type='variable'><doc><text>Register a completed result. + </text><group><param name='what'/><text>The result to register. + </text></group><group><note/><text>Read only + </text></group></doc> + <variable name='provide'><type><function><argtype><mixed/></argtype><returntype><void/></returntype></function></type></variable> + </docgroup> + <docgroup homogen-name='provide_error' homogen-type='variable'><doc><text>Register a failure. + </text><group><param name='what'/><text>The corresponding backtrace. + </text></group><group><note/><text>Read only + </text></group></doc> + <variable name='provide_error'><type><function><argtype><mixed/></argtype><returntype><void/></returntype></function></type></variable> + </docgroup> + <docgroup homogen-name='result' homogen-type='variable'><doc><group><returns/><text>Returns the result if available, a backtrace on failure, + and <expr>0</expr> (zero) otherwise. + </text></group><group><note/><text>Read only + </text></group></doc> + <variable name='result'><type><function><returntype><mixed/></returntype></function></type></variable> + </docgroup> + <docgroup homogen-name='ro' homogen-type='variable'> + <variable name='ro'><type><object resolved='predef::Thread.Farm.Result'>Result</object></type></variable> + </docgroup> + <docgroup homogen-name='set_done_cb' homogen-type='method'><doc><text>Register a callback to be called when + the result is available. + </text><group><param name='to'/><text>Callback to be called. The first + argument to the callback will be + the result or the failure backtrace, + and the second <expr>0</expr> (zero) on + success, and <expr>1</expr> on failure. + </text></group></doc> + <method name='set_done_cb'> + <arguments><argument name='cb'><type><function/></type></argument></arguments> + <returntype><void/></returntype> + </method> + </docgroup> + <docgroup homogen-name='status' homogen-type='variable'><doc><group><returns/><text><int><group><value>1</value><text>Returns <expr>1</expr> when the result is available. + </text></group><group><value>0</value><text>Returns <expr>0</expr> (zero) when the result hasn't + arrived yet. + </text></group><group><value>-1</value><text>Returns negative on failure. + </text></group></int> + </text></group><group><note/><text>Read only + </text></group></doc> + <variable name='status'><type><function><returntype><int/></returntype></function></type></variable> + </docgroup> + </class> <class name='ValueAdjuster'> <modifiers><protected/></modifiers> <docgroup homogen-name='create' homogen-type='method'> <method name='create'><modifiers><protected/></modifiers> <arguments><argument name='r'><type><object resolved='predef::Thread.Farm.ValueAdjuster.create'/></type></argument><argument name='r2'><type><object resolved='predef::Thread.Farm.ValueAdjuster.create'/></type></argument><argument name='i'><type><int/></type></argument><argument name='v'><type><mapping/></type></argument></arguments> <returntype><void/></returntype> </method> </docgroup> <docgroup homogen-type='variable'> <variable name='r'><type><object resolved='predef::Thread.Farm.ValueAdjuster'/></type></variable> <variable name='r2'><type><object resolved='predef::Thread.Farm.ValueAdjuster'/></type></variable> <variable name='i'><type><int/></type></variable> <variable name='v'><type><mapping/></type></variable> </docgroup> </class> </class> <class name='Fifo'> - <modifiers><optional/></modifiers> + <doc><text><ref resolved='predef::Thread.Fifo'>Fifo</ref> implements a fixed length first-in, first-out queue. A fifo is a queue of values and is often used as a stream of data between two threads. </text><group><seealso/><text><ref resolved='predef::Thread.Queue'>Queue</ref> </text></group></doc> <docgroup homogen-name='create' homogen-type='method'><doc><text>Create a fifo. If the optional <ref resolved='predef::Thread.Fifo.create.size'>size</ref> argument is present it sets how many values can be written to the fifo without blocking. The default <ref resolved='predef::Thread.Fifo.create.size'>size</ref> is 128. </text></doc> <method name='create'>
autodoc.git/traditional.xml:133024: <arguments/> <returntype><object resolved='predef::Thread.MutexKey'>MutexKey</object></returntype> </method> <method name='trylock'> <arguments><argument name='type'><type><int/></type></argument></arguments> <returntype><object resolved='predef::Thread.MutexKey'>MutexKey</object></returntype> </method> </docgroup> </class> <class name='MutexKey'> - <modifiers><optional/></modifiers> + <doc><text>Objects of this class are returned by <ref resolved='predef::Thread.Mutex.lock'>Mutex()->lock()</ref> and <ref resolved='predef::Thread.Mutex.trylock'>Mutex()->trylock()</ref>. They are also passed as arguments to <ref resolved='predef::Thread.Condition.wait'>Condition()->wait()</ref>. As long as they are held, the corresponding mutex will be locked. The corresponding mutex will be unlocked when the object is destructed (eg by not having any references left). </text><group><seealso/><text><ref resolved='predef::Thread.Mutex'>Mutex</ref>, <ref resolved='predef::Thread.Condition'>Condition</ref> </text></group></doc> <docgroup homogen-name='create' homogen-type='method'> <method name='create'><modifiers><protected/></modifiers>
autodoc.git/traditional.xml:133047: </method> </docgroup> <docgroup homogen-name='dec_locks' homogen-type='variable'> <variable name='dec_locks'><modifiers><protected/></modifiers><type><function><returntype><void/></returntype></function></type></variable> </docgroup> <docgroup homogen-name='DestructImmediate' homogen-type='inherit'> <inherit name='DestructImmediate'><classname>Builtin.DestructImmediate</classname></inherit> </docgroup> </class> <class name='Queue'> - <modifiers><optional/></modifiers> + <doc><text><ref resolved='predef::Thread.Queue'>Queue</ref> implements a queue, or a pipeline. The main difference between <ref resolved='predef::Thread.Queue'>Queue</ref> and <ref resolved='predef::Thread.Fifo'>Fifo</ref> is that <ref resolved='predef::Thread.Queue'>Queue</ref> will never block in write(), only allocate more memory. </text><group><fixme/><text>Ought to be made API-compatible with <ref resolved='predef::ADT.Queue'>ADT.Queue</ref>. </text></group><group><seealso/><text><ref resolved='predef::Thread.Fifo'>Fifo</ref>, <ref resolved='predef::ADT.Queue'>ADT.Queue</ref> </text></group></doc> <docgroup homogen-name='lock' homogen-type='inherit'> <inherit name='lock'><classname resolved='predef::Thread.Mutex'>Mutex</classname></inherit> </docgroup> <docgroup homogen-name='r_cond' homogen-type='inherit'>
autodoc.git/traditional.xml:133133: The number of items in the queue after the write is returned. </text><group><seealso/><text><ref resolved='predef::Thread.Queue.read'>read()</ref> </text></group></doc> <method name='write'> <arguments><argument name='value'><type><mixed/></type></argument></arguments> <returntype><int/></returntype> </method> </docgroup> </class> <class name='ResourceCount'> - <modifiers><optional/></modifiers> + <doc><text>Implements an inverted-semaphore-like resource counter. A thread can poll or perform a blocking wait for the resource-count to drop below a certain <ref>level</ref>. </text><group><seealso/><text><ref resolved='predef::Thread.ResourceCountKey'>ResourceCountKey</ref>, <ref resolved='predef::Thread.Condition'>Condition</ref>, <ref resolved='predef::Thread.Mutex'>Mutex</ref> </text></group></doc> <docgroup homogen-name='acquire' homogen-type='method'><doc><text>Increments the resource-counter. </text><group><returns/><text>A <ref resolved='predef::Thread.ResourceCountKey'>ResourceCountKey</ref> to decrement the resource-counter again. </text></group></doc> <method name='acquire'><modifiers><final/></modifiers> <arguments/>
autodoc.git/traditional.xml:133165: <docgroup homogen-name='wait_till_drained' homogen-type='method'><doc><text>Blocks until the resource-counter dips to max <ref resolved='predef::Thread.ResourceCount.wait_till_drained.level'>level</ref>. </text><group><param name='level'/><text>The maximum level that is considered drained. </text></group></doc> <method name='wait_till_drained'><modifiers><final/></modifiers> <arguments><argument name='level'><type><or><void/><int/></or></type></argument></arguments> <returntype><void/></returntype> </method> </docgroup> </class> <class name='ResourceCountKey'> - <modifiers><optional/></modifiers> + <doc><text>When this key is destroyed, the corresponding resource counter will be decremented. </text><group><seealso/><text><ref resolved='predef::Thread.ResourceCount'>ResourceCount</ref>, <ref resolved='predef::Thread.MutexKey'>MutexKey</ref> </text></group></doc> <docgroup homogen-name='DestructImmediate' homogen-type='inherit'> <inherit name='DestructImmediate'><modifiers><private/></modifiers><classname>__builtin.DestructImmediate</classname></inherit> </docgroup> </class> <class name='Thread'> <docgroup homogen-name='_sprintf' homogen-type='method'><doc><text>Returns a string identifying the thread.

autodoc.git / traditional.xml