Changeset 99739 in vbox for trunk/src/VBox/Storage
- Timestamp:
- May 11, 2023 1:01:08 AM (22 months ago)
- svn:sync-xref-src-repo-rev:
- 157315
- Location:
- trunk/src/VBox/Storage
- Files:
-
- 19 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/VBox/Storage/CUE.cpp
r98103 r99739 334 334 * Skip one character in the input stream. 335 335 * 336 * @returns nothing.337 336 * @param pTokenizer The tokenizer state. 338 337 */ … … 379 378 * Sets a new line for the tokenizer. 380 379 * 381 * @returns nothing.382 380 * @param pTokenizer The tokenizer state. 383 381 * @param cSkip How many characters to skip. … … 415 413 * Skips all present comments too. 416 414 * 417 * @returns nothing.418 415 * @param pTokenizer The tokenizer state. 419 416 */ … … 435 432 * Skips a multi line comment. 436 433 * 437 * @returns nothing.438 434 * @param pTokenizer The tokenizer state. 439 435 */ … … 449 445 * Get an identifier token from the tokenizer. 450 446 * 451 * @returns nothing.452 447 * @param pTokenizer The tokenizer state. 453 448 * @param pToken The uninitialized token. … … 512 507 * Get an integer value or MSF location indicator from the tokenizer. 513 508 * 514 * @returns nothing.515 509 * @param pTokenizer The tokenizer state. 516 510 * @param pToken The uninitialized token. … … 577 571 * Parses a string constant. 578 572 * 579 * @returns nothing.580 573 * @param pTokenizer The tokenizer state. 581 574 * @param pToken The uninitialized token. … … 613 606 * Get the end of stream token. 614 607 * 615 * @returns nothing.616 608 * @param pTokenizer The tokenizer state. 617 609 * @param pToken The uninitialized token. … … 627 619 * Read the next token from the tokenizer stream. 628 620 * 629 * @returns nothing.630 621 * @param pTokenizer The tokenizer to read from. 631 622 * @param pToken Uninitialized token to fill the token data into. … … 697 688 * Consume the current token advancing to the next in the stream. 698 689 * 699 * @returns nothing.700 690 * @param pTokenizer The tokenizer state. 701 691 */ -
trunk/src/VBox/Storage/ISCSI.cpp
r98103 r99739 839 839 * Dumps an iSCSI packet if enabled. 840 840 * 841 * @returns nothing.842 841 * @param pImage The iSCSI image instance data. 843 842 * @param paISCSISegs Pointer to the segments array. -
trunk/src/VBox/Storage/QCOW.cpp
r98103 r99739 454 454 * Creates a QCOW header from the given image state. 455 455 * 456 * @returns nothing.457 456 * @param pImage Image instance data. 458 457 * @param pHeader Pointer to the header to convert. … … 500 499 * Convert table entries from little endian to host endianess. 501 500 * 502 * @returns nothing.503 501 * @param paTbl Pointer to the table. 504 502 * @param cEntries Number of entries in the table. … … 506 504 static void qcowTableConvertToHostEndianess(uint64_t *paTbl, uint32_t cEntries) 507 505 { 508 while (cEntries-- > 0)506 while (cEntries-- > 0) 509 507 { 510 508 *paTbl = RT_BE2H_U64(*paTbl); … … 516 514 * Convert table entries from host to little endian format. 517 515 * 518 * @returns nothing.519 516 * @param paTblImg Pointer to the table which will store the little endian table. 520 517 * @param paTbl The source table to convert. 521 518 * @param cEntries Number of entries in the table. 522 519 */ 523 static void qcowTableConvertFromHostEndianess(uint64_t *paTblImg, uint64_t *paTbl,520 static void qcowTableConvertFromHostEndianess(uint64_t *paTblImg, uint64_t const *paTbl, 524 521 uint32_t cEntries) 525 522 { 526 while (cEntries-- > 0)523 while (cEntries-- > 0) 527 524 { 528 525 *paTblImg = RT_H2BE_U64(*paTbl); … … 550 547 * Destroys the L2 table cache. 551 548 * 552 * @returns nothing.553 549 * @param pImage The image instance data. 554 550 */ … … 609 605 * Releases a L2 table cache entry. 610 606 * 611 * @returns nothing.612 607 * @param pL2Entry The L2 cache entry. 613 608 */ … … 675 670 * Frees a L2 table cache entry. 676 671 * 677 * @returns nothing.678 672 * @param pImage The image instance data. 679 673 * @param pL2Entry The L2 cache entry to free. … … 691 685 * Inserts an entry in the L2 table cache. 692 686 * 693 * @returns nothing.694 687 * @param pImage The image instance data. 695 688 * @param pL2Entry The L2 cache entry to insert. … … 790 783 * Sets the L1, L2 and offset bitmasks and L1 and L2 bit shift members. 791 784 * 792 * @returns nothing.793 785 * @param pImage The image instance data. 794 786 */ … … 811 803 * Converts a given logical offset into the 812 804 * 813 * @returns nothing.814 805 * @param pImage The image instance data. 815 806 * @param off The logical offset to convert. -
trunk/src/VBox/Storage/QED.cpp
r98103 r99739 2 2 /** @file 3 3 * QED - QED Disk image. 4 * 5 * The QED backend implements support for the qemu enhanced disk format (short QED) 6 * The specification for the format is available under http://wiki.qemu.org/Features/QED/Specification 7 * 8 * Missing things to implement: 9 * - compaction 10 * - resizing which requires block relocation (very rare case) 4 11 */ 5 12 … … 44 51 #include "VDBackends.h" 45 52 #include "VDBackendsInline.h" 46 47 /**48 * The QED backend implements support for the qemu enhanced disk format (short QED)49 * The specification for the format is available under http://wiki.qemu.org/Features/QED/Specification50 *51 * Missing things to implement:52 * - compaction53 * - resizing which requires block relocation (very rare case)54 */55 53 56 54 … … 330 328 * Creates a QED header from the given image state. 331 329 * 332 * @returns nothing.333 330 * @param pImage Image instance data. 334 331 * @param pHeader Pointer to the header to convert. … … 352 349 * Convert table entries from little endian to host endianess. 353 350 * 354 * @returns nothing.355 351 * @param paTbl Pointer to the table. 356 352 * @param cEntries Number of entries in the table. … … 358 354 static void qedTableConvertToHostEndianess(uint64_t *paTbl, uint32_t cEntries) 359 355 { 360 while (cEntries-- > 0)356 while (cEntries-- > 0) 361 357 { 362 358 *paTbl = RT_LE2H_U64(*paTbl); … … 369 365 * Convert table entries from host to little endian format. 370 366 * 371 * @returns nothing.372 367 * @param paTblImg Pointer to the table which will store the little endian table. 373 368 * @param paTbl The source table to convert. 374 369 * @param cEntries Number of entries in the table. 375 370 */ 376 static void qedTableConvertFromHostEndianess(uint64_t *paTblImg, uint64_t *paTbl,371 static void qedTableConvertFromHostEndianess(uint64_t *paTblImg, uint64_t const *paTbl, 377 372 uint32_t cEntries) 378 373 { 379 while (cEntries-- > 0)374 while (cEntries-- > 0) 380 375 { 381 376 *paTblImg = RT_H2LE_U64(*paTbl); … … 404 399 * Destroys the L2 table cache. 405 400 * 406 * @returns nothing.407 401 * @param pImage The image instance data. 408 402 */ … … 463 457 * Releases a L2 table cache entry. 464 458 * 465 * @returns nothing.466 459 * @param pL2Entry The L2 cache entry. 467 460 */ … … 529 522 * Frees a L2 table cache entry. 530 523 * 531 * @returns nothing.532 524 * @param pImage The image instance data. 533 525 * @param pL2Entry The L2 cache entry to free. … … 545 537 * Inserts an entry in the L2 table cache. 546 538 * 547 * @returns nothing.548 539 * @param pImage The image instance data. 549 540 * @param pL2Entry The L2 cache entry to insert. … … 663 654 * Sets the L1, L2 and offset bitmasks and L1 and L2 bit shift members. 664 655 * 665 * @returns nothing.666 656 * @param pImage The image instance data. 667 657 */ … … 685 675 * Converts a given logical offset into the 686 676 * 687 * @returns nothing.688 677 * @param pImage The image instance data. 689 678 * @param off The logical offset to convert. -
trunk/src/VBox/Storage/VCICache.cpp
r98103 r99739 507 507 * Frees a block map. 508 508 * 509 * @returns nothing.510 509 * @param pBlkMap The block bitmap to destroy. 511 510 */ … … 926 925 * Frees a range of blocks. 927 926 * 928 * @returns nothing.929 927 * @param pBlkMap The block bitmap. 930 928 * @param offBlockAddr Address of the first block to free. -
trunk/src/VBox/Storage/VD.cpp
r98103 r99739 1487 1487 * Processes the list of blocked I/O contexts. 1488 1488 * 1489 * @returns nothing.1490 1489 * @param pDisk The disk structure. 1491 1490 */ … … 3605 3604 * Processes a list of waiting I/O tasks. The disk lock must be held by caller. 3606 3605 * 3607 * @returns nothing.3608 3606 * @param pDisk The disk to process the list for. 3609 3607 */ … … 3650 3648 * Process any I/O context on the halted list. 3651 3649 * 3652 * @returns nothing.3653 3650 * @param pDisk The disk. 3654 3651 */ … … 3740 3737 * The completion is deferred if the disk is locked already. 3741 3738 * 3742 * @returns nothing.3743 3739 * @param pIoTask The I/O task to complete. 3744 3740 */ … … 4934 4930 * Sets the I/O callbacks of the given interface to the fallback methods 4935 4931 * 4936 * @returns nothing.4937 4932 * @param pIfIo The I/O interface to setup. 4938 4933 */ … … 4959 4954 * Sets the internal I/O callbacks of the given interface. 4960 4955 * 4961 * @returns nothing.4962 4956 * @param pIfIoInt The internal I/O interface to setup. 4963 4957 */ -
trunk/src/VBox/Storage/VDI.cpp
r98103 r99739 351 351 * Internal: Init VDI header. Always use latest header version. 352 352 * 353 * @returns nothing.354 353 * @param pHeader Assumes it was initially initialized to all zeros. 355 354 * @param uImageFlags Flags for this image. -
trunk/src/VBox/Storage/VHDX.cpp
r98103 r99739 617 617 * Converts the file identifier between file and host endianness. 618 618 * 619 * @returns nothing.620 619 * @param enmConv Direction of the conversion. 621 620 * @param pFileIdentifierConv Where to store the converted file identifier. … … 635 634 * Converts a UUID between file and host endianness. 636 635 * 637 * @returns nothing.638 636 * @param enmConv Direction of the conversion. 639 637 * @param pUuidConv Where to store the converted UUID. … … 665 663 * Converts a VHDX header between file and host endianness. 666 664 * 667 * @returns nothing.668 665 * @param enmConv Direction of the conversion. 669 666 * @param pHdrConv Where to store the converted header. … … 689 686 * Converts a VHDX region table header between file and host endianness. 690 687 * 691 * @returns nothing.692 688 * @param enmConv Direction of the conversion. 693 689 * @param pRegTblHdrConv Where to store the converted header. … … 708 704 * Converts a VHDX region table entry between file and host endianness. 709 705 * 710 * @returns nothing.711 706 * @param enmConv Direction of the conversion. 712 707 * @param pRegTblEntConv Where to store the converted region table entry. … … 729 724 * Converts a VHDX log entry header between file and host endianness. 730 725 * 731 * @returns nothing.732 726 * @param enmConv Direction of the conversion. 733 727 * @param pLogEntryHdrConv Where to store the converted log entry header. … … 753 747 * Converts a VHDX log zero descriptor between file and host endianness. 754 748 * 755 * @returns nothing.756 749 * @param enmConv Direction of the conversion. 757 750 * @param pLogZeroDescConv Where to store the converted log zero descriptor. … … 774 767 * Converts a VHDX log data descriptor between file and host endianness. 775 768 * 776 * @returns nothing.777 769 * @param enmConv Direction of the conversion. 778 770 * @param pLogDataDescConv Where to store the converted log data descriptor. … … 795 787 * Converts a VHDX log data sector between file and host endianness. 796 788 * 797 * @returns nothing.798 789 * @param enmConv Direction of the conversion. 799 790 * @param pLogDataSectorConv Where to store the converted log data sector. … … 815 806 * Converts a BAT between file and host endianess. 816 807 * 817 * @returns nothing.818 808 * @param enmConv Direction of the conversion. 819 809 * @param paBatEntriesConv Where to store the converted BAT. … … 833 823 * Converts a VHDX metadata table header between file and host endianness. 834 824 * 835 * @returns nothing.836 825 * @param enmConv Direction of the conversion. 837 826 * @param pMetadataTblHdrConv Where to store the converted metadata table header. … … 853 842 * Converts a VHDX metadata table entry between file and host endianness. 854 843 * 855 * @returns nothing.856 844 * @param enmConv Direction of the conversion. 857 845 * @param pMetadataTblEntryConv Where to store the converted metadata table entry. … … 873 861 * Converts a VHDX file parameters item between file and host endianness. 874 862 * 875 * @returns nothing.876 863 * @param enmConv Direction of the conversion. 877 864 * @param pFileParamsConv Where to store the converted file parameters item entry. … … 890 877 * Converts a VHDX virtual disk size item between file and host endianness. 891 878 * 892 * @returns nothing.893 879 * @param enmConv Direction of the conversion. 894 880 * @param pVDiskSizeConv Where to store the converted virtual disk size item entry. … … 908 894 * Converts a VHDX page 83 data item between file and host endianness. 909 895 * 910 * @returns nothing.911 896 * @param enmConv Direction of the conversion. 912 897 * @param pPage83DataConv Where to store the converted page 83 data item entry. … … 925 910 * Converts a VHDX logical sector size item between file and host endianness. 926 911 * 927 * @returns nothing.928 912 * @param enmConv Direction of the conversion. 929 913 * @param pVDiskLogSectSizeConv Where to store the converted logical sector size item entry. … … 943 927 * Converts a VHDX physical sector size item between file and host endianness. 944 928 * 945 * @returns nothing.946 929 * @param enmConv Direction of the conversion. 947 930 * @param pVDiskPhysSectSizeConv Where to store the converted physical sector size item entry. … … 960 943 * Converts a VHDX parent locator header item between file and host endianness. 961 944 * 962 * @returns nothing.963 945 * @param enmConv Direction of the conversion. 964 946 * @param pParentLocatorHdrConv Where to store the converted parent locator header item entry. … … 979 961 * Converts a VHDX parent locator entry between file and host endianness. 980 962 * 981 * @returns nothing.982 963 * @param enmConv Direction of the conversion. 983 964 * @param pParentLocatorEntryConv Where to store the converted parent locator entry. -
trunk/src/VBox/Storage/VMDK.cpp
r98103 r99739 1166 1166 * Converts the grain directory from little to host endianess. 1167 1167 * 1168 * @returns nothing.1169 1168 * @param pGD The grain directory. 1170 1169 * @param cGDEntries Number of entries in the grain directory to convert. … … 7371 7370 * Destroys the given rename state, freeing all allocated memory. 7372 7371 * 7373 * @returns nothing.7374 7372 * @param pRenameState The rename state to destroy. 7375 7373 */ -
trunk/src/VBox/Storage/testcase/VDIoBackend.h
r98103 r99739 50 50 * Completion handler. 51 51 * 52 * @returns nothing.52 * @returns IPRT status code. 53 53 * @param pvUser Opaque user data. 54 54 * @param rcReq Completion code for the request. … … 69 69 /** 70 70 * Destroys a memory I/O backend. 71 *72 * @returns nothing.73 71 * 74 72 * @param pIoBackend The backend to destroy. -
trunk/src/VBox/Storage/testcase/VDIoBackendMem.h
r98103 r99739 44 44 /** 45 45 * Completion handler. 46 * 47 * @returns nothing.46 * 47 * @returns IPRT status code. 48 48 * @param pvUser Opaque user data. 49 49 * @param rcReq Completion code for the request. -
trunk/src/VBox/Storage/testcase/VDMemDisk.h
r98103 r99739 54 54 /** 55 55 * Destroys a memory disk. 56 *57 * @returns nothing.58 56 * 59 57 * @param pMemDisk The memory disk to destroy. -
trunk/src/VBox/Storage/testcase/VDScript.cpp
r98103 r99739 338 338 * Skip one character in the input stream. 339 339 * 340 * @returns nothing.341 340 * @param pTokenizer The tokenizer state. 342 341 */ … … 383 382 * Sets a new line for the tokenizer. 384 383 * 385 * @returns nothing.386 384 * @param pTokenizer The tokenizer state. 387 385 */ … … 420 418 * Skips a multi line comment. 421 419 * 422 * @returns nothing.423 420 * @param pTokenizer The tokenizer state. 424 421 */ … … 443 440 * Skips all present comments too. 444 441 * 445 * @returns nothing.446 442 * @param pTokenizer The tokenizer state. 447 443 */ … … 473 469 * Get an identifier token from the tokenizer. 474 470 * 475 * @returns nothing.476 471 * @param pTokenizer The tokenizer state. 477 472 * @param pToken The uninitialized token. … … 520 515 * Get a numerical constant from the tokenizer. 521 516 * 522 * @returns nothing.523 517 * @param pTokenizer The tokenizer state. 524 518 * @param pToken The uninitialized token. … … 566 560 * Parses a string constant. 567 561 * 568 * @returns nothing.569 562 * @param pTokenizer The tokenizer state. 570 563 * @param pToken The uninitialized token. 571 564 * 572 * @remarks :No escape sequences allowed at this time.565 * @remarks No escape sequences allowed at this time. 573 566 */ 574 567 static void vdScriptTokenizerGetStringConst(PVDTOKENIZER pTokenizer, PVDSCRIPTTOKEN pToken) … … 598 591 * Get the end of stream token. 599 592 * 600 * @returns nothing.601 593 * @param pTokenizer The tokenizer state. 602 594 * @param pToken The uninitialized token. … … 613 605 * Get operator or punctuator token. 614 606 * 615 * @returns nothing.616 607 * @param pTokenizer The tokenizer state. 617 608 * @param pToken The uninitialized token. … … 669 660 * Read the next token from the tokenizer stream. 670 661 * 671 * @returns nothing.672 662 * @param pTokenizer The tokenizer to read from. 673 663 * @param pToken Uninitialized token to fill the token data into. … … 721 711 * Destroys a given tokenizer state. 722 712 * 723 * @returns nothing.724 713 * @param pTokenizer The tokenizer to destroy. 725 714 */ … … 766 755 * Consume the current token advancing to the next in the stream. 767 756 * 768 * @returns nothing.769 757 * @param pTokenizer The tokenizer state. 770 758 */ … … 1321 1309 * Parse a storage class specifier. 1322 1310 * 1323 * @returns nothing.1324 1311 * @param pThis The script context. 1325 1312 * @param penmStorageClass Where to return the parsed storage classe. … … 1355 1342 * Parse a type qualifier. 1356 1343 * 1357 * @returns nothing.1358 1344 * @param pThis The script context. 1359 1345 * @param penmTypeQualifier Where to return the parsed type qualifier. -
trunk/src/VBox/Storage/testcase/VDScript.h
r98103 r99739 166 166 * Destroys the given scripting context. 167 167 * 168 * @returns nothing.169 168 * @param hScriptCtx The script context to destroy. 170 169 */ -
trunk/src/VBox/Storage/testcase/VDScriptAst.cpp
r98103 r99739 38 38 * Put all child nodes of the given expression AST node onto the given to free list. 39 39 * 40 * @returns nothing.41 40 * @param pList The free list to append everything to. 42 41 * @param pAstNode The expression node to free. … … 147 146 * Free a given statement AST node and put everything on the given to free list. 148 147 * 149 * @returns nothing.150 148 * @param pList The free list to append everything to. 151 149 * @param pAstNode The statement node to free. -
trunk/src/VBox/Storage/testcase/VDScriptAst.h
r98103 r99739 569 569 * by the given node. 570 570 * 571 * @returns nothing.572 571 * @param pAstNode The AST node to free. 573 572 */ -
trunk/src/VBox/Storage/testcase/VDScriptInterp.cpp
r98103 r99739 185 185 * Pops the topmost value from the value stack. 186 186 * 187 * @returns nothing.188 187 * @param pThis The interpreter context. 189 188 * @param pVal Where to store the value. … … 430 429 * Destroys the current scope. 431 430 * 432 * @returns nothing.433 431 * @param pThis The interpreter context. 434 432 */ -
trunk/src/VBox/Storage/testcase/VDScriptStack.h
r98103 r99739 57 57 * Init the stack structure. 58 58 * 59 * @returns nothing.60 59 * @param pStack The stack to initialize. 61 60 * @param cbStackEntry The size of one stack entry. … … 72 71 * Destroys the given stack freeing all memory. 73 72 * 74 * @returns nothing.75 73 * @param pStack The stack to destroy. 76 74 */ … … 135 133 * Increases the used element count for the given stack. 136 134 * 137 * @returns nothing.138 135 * @param pStack The stack. 139 136 */ … … 146 143 * Decreases the used element count for the given stack. 147 144 * 148 * @returns nothing.149 145 * @param pStack The stack. 150 146 */ -
trunk/src/VBox/Storage/testcase/tstVDIo.cpp
r98103 r99739 2778 2778 * Executes the given script. 2779 2779 * 2780 * @returns nothing.2781 2780 * @param pszName The script name. 2782 2781 * @param pszScript The script to execute. … … 2903 2902 * Executes the given I/O script using the new scripting engine. 2904 2903 * 2905 * @returns nothing.2906 *2907 2904 * @param pcszFilename The script to execute. 2908 2905 */ … … 2930 2927 /** 2931 2928 * Run builtin tests. 2932 *2933 * @returns nothing.2934 2929 */ 2935 2930 static void tstVDIoRunBuiltinTests(void)
Note:
See TracChangeset
for help on using the changeset viewer.