Changeset abbc16e in mainline


Ignore:
Timestamp:
2006-06-16T11:17:54Z (19 years ago)
Author:
Jakub Jermar <jakub@…>
Branches:
lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export
Children:
62939f7
Parents:
b6529ae
Message:

Fix some broken doxygen comments.

Files:
20 edited

Legend:

Unmodified
Added
Removed

  • arch/ia32/src/smp/apic.c

    rb6529ae rabbc16e  
    174174 *
    175175 * @param n Interrupt vector.
    176  * @param stack Interrupted stack.
     176 * @param istate Interrupted state.
    177177 */
    178178void apic_spurious(int n, istate_t *istate)
    … …  
    444444 *
    445445 * @param n Interrupt vector number.
    446  * @param stack Interrupted stack.
     446 * @param istate Interrupted state.
    447447 */
    448448void l_apic_timer_interrupt(int n, istate_t *istate)
    … …  
    483483 *
    484484 * @param address IO APIC register address.
    485  * @param Content to be written to the addressed IO APIC register.
     485 * @param x Content to be written to the addressed IO APIC register.
    486486 */
    487487void io_apic_write(__u8 address, __u32 x)

  • arch/ia64/include/asm.h

    rb6529ae rabbc16e  
    8383/** Write IVA (Interruption Vector Address) register.
    8484 *
    85  * @param New location of interruption vector table.
     85 * @param v New location of interruption vector table.
    8686 */
    8787static inline void iva_write(__u64 v)
    … …  
    106106/** Write ITC (Interval Timer Counter) register.
    107107 *
    108  * @param New counter value.
     108 * @param v New counter value.
    109109 */
    110110static inline void itc_write(__u64 v)
    … …  
    128128/** Write ITM (Interval Timer Match) register.
    129129 *
    130  * @param New match value.
     130 * @param v New match value.
    131131 */
    132132static inline void itm_write(__u64 v)
    … …  
    163163/** Write ITV (Interval Timer Vector) register.
    164164 *
    165  * @param New vector and mask bit.
     165 * @param v New vector and mask bit.
    166166 */
    167167static inline void itv_write(__u64 v)
    … …  
    172172/** Write EOI (End Of Interrupt) register.
    173173 *
    174  * @param This value is ignored.
     174 * @param v This value is ignored.
    175175 */
    176176static inline void eoi_write(__u64 v)
    … …  
    194194/** Write TPR (Task Priority Register).
    195195 *
    196  * @param New value of TPR.
     196 * @param v New value of TPR.
    197197 */
    198198static inline void tpr_write(__u64 v)

  • arch/ia64/include/faddr.h

    rb6529ae rabbc16e  
    4343 * referenced by fptr pointer.
    4444 *
    45  * @param fptr Function pointer.
     45 * @param f Function pointer.
    4646 *
    4747 */

  • arch/ia64/src/mm/page.c

    rb6529ae rabbc16e  
    211211/** Set up one VHPT entry.
    212212 *
    213  * @param t VHPT entry to be set up.
     213 * @param v VHPT entry to be set up.
    214214 * @param page Virtual address of the page mapped by the entry.
    215215 * @param asid Address space identifier of the address space to which page belongs.

  • arch/ia64/src/mm/tlb.c

    rb6529ae rabbc16e  
    298298 * @param asid Address space identifier.
    299299 * @param entry The rest of TLB entry as required by TLB insertion format.
    300  * @param dtc If true, insert into data translation register, use instruction translation register otherwise.
     300 * @param dtr If true, insert into data translation register, use instruction translation register otherwise.
    301301 * @param tr Translation register.
    302302 */

  • arch/ppc32/src/mm/page.c

    rb6529ae rabbc16e  
    6868 */
    6969static pte_t *find_mapping_and_check(as_t *as, bool lock, __address badvaddr, int access,
    70                                      istate_t *istate, int *pfcr)
     70                                     istate_t *istate, int *pfrc)
    7171{
    7272        /*
    … …  
    100100                        case AS_PF_DEFER:
    101101                                page_table_lock(as, lock);
    102                                 *pfcr = rc;
     102                                *pfrc = rc;
    103103                                return NULL;
    104104                        case AS_PF_FAULT:
    105105                                page_table_lock(as, lock);
    106106                                printf("Page fault.\n");
    107                                 *pfcr = rc;
     107                                *pfrc = rc;
    108108                                return NULL;
    109109                        default:
    … …  
    191191/** Process Instruction/Data Storage Interrupt
    192192 *
    193  * @param data   True if Data Storage Interrupt.
     193 * @param n Interrupt vector number.
    194194 * @param istate Interrupted register context.
    195195 *
    … …  
    199199        __address badvaddr;
    200200        pte_t *pte;
    201         int pfcr;
     201        int pfrc;
    202202        as_t *as;
    203203        bool lock;
    … …  
    221221        page_table_lock(as, lock);
    222222       
    223         pte = find_mapping_and_check(as, lock, badvaddr, PF_ACCESS_READ /* FIXME */, istate, &pfcr);
     223        pte = find_mapping_and_check(as, lock, badvaddr, PF_ACCESS_READ /* FIXME */, istate, &pfrc);
    224224        if (!pte) {
    225                 switch (pfcr) {
     225                switch (pfrc) {
    226226                        case AS_PF_FAULT:
    227227                                goto fail;
    … …  
    235235                                return;
    236236                        default:
    237                                 panic("Unexpected pfrc (%d)\n", pfcr);
     237                                panic("Unexpected pfrc (%d)\n", pfrc);
    238238                }
    239239        }

  • arch/ppc64/src/mm/page.c

    rb6529ae rabbc16e  
    6767 */
    6868static pte_t *find_mapping_and_check(as_t *as, bool lock, __address badvaddr, int access,
    69                                      istate_t *istate, int *pfcr)
     69                                     istate_t *istate, int *pfrc)
    7070{
    7171        /*
    … …  
    9999                        case AS_PF_DEFER:
    100100                                page_table_lock(as, lock);
    101                                 *pfcr = rc;
     101                                *pfrc = rc;
    102102                                return NULL;
    103103                        case AS_PF_FAULT:
    104104                                page_table_lock(as, lock);
    105105                                printf("Page fault.\n");
    106                                 *pfcr = rc;
     106                                *pfrc = rc;
    107107                                return NULL;
    108108                        default:
    … …  
    198198        __address badvaddr;
    199199        pte_t *pte;
    200         int pfcr;
     200        int pfrc;
    201201        as_t *as;
    202202        bool lock;
    … …  
    220220        page_table_lock(as, lock);
    221221       
    222         pte = find_mapping_and_check(as, lock, badvaddr, PF_ACCESS_READ /* FIXME */, istate, &pfcr);
     222        pte = find_mapping_and_check(as, lock, badvaddr, PF_ACCESS_READ /* FIXME */, istate, &pfrc);
    223223        if (!pte) {
    224                 switch (pfcr) {
     224                switch (pfrc) {
    225225                        case AS_PF_FAULT:
    226226                                goto fail;
    … …  
    234234                                return;
    235235                        default:
    236                                 panic("Unexpected pfrc (%d)\n", pfcr);
     236                                panic("Unexpected pfrc (%d)\n", pfrc);
    237237                }
    238238        }

  • arch/sparc64/include/asm.h

    rb6529ae rabbc16e  
    5656/** Write Processor State register.
    5757 *
    58  * @param New value of PSTATE register.
     58 * @param v New value of PSTATE register.
    5959 */
    6060static inline void pstate_write(__u64 v)
    … …  
    7878/** Write TICK_compare Register.
    7979 *
    80  * @param New value of TICK_comapre register.
     80 * @param v New value of TICK_comapre register.
    8181 */
    8282static inline void tick_compare_write(__u64 v)
    … …  
    100100/** Write TICK Register.
    101101 *
    102  * @param New value of TICK register.
     102 * @param v New value of TICK register.
    103103 */
    104104static inline void tick_write(__u64 v)
    … …  
    122122/** Write SOFTINT Register.
    123123 *
    124  * @param New value of SOFTINT register.
     124 * @param v New value of SOFTINT register.
    125125 */
    126126static inline void softint_write(__u64 v)
    … …  
    133133 * Bits set in CLEAR_SOFTINT register will be cleared in SOFTINT register.
    134134 *
    135  * @param New value of CLEAR_SOFTINT register.
     135 * @param v New value of CLEAR_SOFTINT register.
    136136 */
    137137static inline void clear_softint_write(__u64 v)
    … …  
    271271/** Write Trap Base Address register.
    272272 *
    273  * @param New value of TBA.
     273 * @param v New value of TBA.
    274274 */
    275275static inline void tba_write(__u64 v)

  • genarch/src/i8042/i8042.c

    rb6529ae rabbc16e  
    319319 *
    320320 * @param n Interrupt vector.
    321  * @param stack Interrupted stack.
     321 * @param istate Interrupted state.
    322322 */
    323323void i8042_interrupt(int n, istate_t *istate)

  • generic/src/adt/btree.c

    rb6529ae rabbc16e  
    215215/** Remove B-tree node.
    216216 *
    217  * @param B-tree.
     217 * @param t B-tree.
    218218 * @param key Key to be removed from the B-tree along with its associated value.
    219219 * @param leaf_node If not NULL, pointer to the leaf node where the key is found.
    … …  
    235235/** Recursively remove B-tree node.
    236236 *
    237  * @param B-tree.
     237 * @param t B-tree.
    238238 * @param key Key to be removed from the B-tree along with its associated value.
    239239 * @param node Node where the key being removed resides.
    … …  
    903903/** Rotate in a key from the right sibling or from the index node, if this operation can be done.
    904904 *
    905  * @param rnode Node into which to add key from its right sibling or from the index node.
     905 * @param lnode Node into which to add key from its right sibling or from the index node.
    906906 *
    907907 * @return True if the rotation was performed, false otherwise.

  • generic/src/adt/hash_table.c

    rb6529ae rabbc16e  
    7878 *
    7979 * @param h Hash table.
    80  * @param hey Array of all keys necessary to compute hash index.
     80 * @param key Array of all keys necessary to compute hash index.
    8181 * @param item Item to be inserted into the hash table.
    8282 */

  • generic/src/console/console.c

    rb6529ae rabbc16e  
    118118 * @param chardev Character device.
    119119 * @param buf Buffer where to store string terminated by '\0'.
    120  * @param len Size of the buffer.
     120 * @param buflen Size of the buffer.
    121121 *
    122122 * @return Number of characters read.

  • generic/src/console/kconsole.c

    rb6529ae rabbc16e  
    404404/** Kernel console managing thread.
    405405 *
    406  * @param arg Not used.
     406 * @param prompt Kernel console prompt (e.g kconsole/panic).
    407407 */
    408408void kconsole(void *prompt)

  • generic/src/ddi/ddi.c

    rb6529ae rabbc16e  
    169169/** Wrapper for SYS_ENABLE_IOSPACE syscall.
    170170 *
    171  * @param User space address of DDI argument structure.
     171 * @param uspace_io_arg User space address of DDI argument structure.
    172172 *
    173173 * @return 0 on success, otherwise it returns error code found in errno.h

  • generic/src/ipc/ipc.c

    rb6529ae rabbc16e  
    210210/** Send a asynchronous request using phone to answerbox
    211211 *
    212  * @param phone Phone connected to answerbox
    213  * @param request Request to be sent
     212 * @param phone Phone connected to answerbox.
     213 * @param call Structure representing the call.
    214214 */
    215215int ipc_call(phone_t *phone, call_t *call)

  • generic/src/lib/func.c

    rb6529ae rabbc16e  
    136136 *
    137137 * @param src Source string.
    138  * @param dst Destination buffer.
     138 * @param dest Destination buffer.
    139139 * @param len Size of destination buffer.
    140140 */

  • generic/src/mm/buddy.c

    rb6529ae rabbc16e  
    287287 *
    288288 * @param b Pointer to buddy system
    289  * @param es Element size
     289 * @param elem_size Element size
    290290 */
    291291void buddy_system_structure_print(buddy_system_t *b, size_t elem_size) {

  • generic/src/mm/frame.c

    rb6529ae rabbc16e  
    996996 * If it drops to zero, move the frame structure to free list.
    997997 *
    998  * @param frame Frame number to be freed.
     998 * @param pfn Frame number of the frame to be freed.
    999999 */
    10001000void frame_free(pfn_t pfn)
    … …  
    10221022 * increment frame reference count.
    10231023 *
    1024  * @param frame Frame no to be freed.
     1024 * @param pfn Frame number of the frame to be freed.
    10251025 */
    10261026void frame_reference_add(pfn_t pfn)
    … …  
    11131113}
    11141114
    1115 /** Prints zone details
    1116  *
    1117  * @param base Zone base address OR zone number
     1115/** Prints zone details.
     1116 *
     1117 * @param num Zone base address or zone number.
    11181118 */
    11191119void zone_print_one(int num) {

  • generic/src/proc/scheduler.c

    rb6529ae rabbc16e  
    254254 * When the function decides to relink rq's, it reconnects
    255255 * respective pointers so that in result threads with 'pri'
    256  * greater or equal @start are moved to a higher-priority queue.
     256 * greater or equal start are moved to a higher-priority queue.
    257257 *
    258258 * @param start Threshold priority.

  • generic/src/syscall/copy.c

    rb6529ae rabbc16e  
    9595 *
    9696 * @param uspace_dst Destination userspace address.
    97  * @param uspace_src Source kernel address.
     97 * @param src Source kernel address.
    9898 * @param size Size of the data to be copied.
    9999 *
Note: See TracChangeset for help on using the changeset viewer.