Victor Sun (11):
HV: rename the term of vm0 to sos vm
HV: refine launch vm interface
HV: show correct vm name per config
HV: add get_sos_vm api
HV: remove sworld_supported in acrn_vm_config
HV: remove unused vm num config
HV: enable pcpu bitmap config for partition mode
HV: remove vm_config pointer in acrn_vm struct
HV: replace memory config with acrn_vm_mem_config
HV: replace bootargs config with acrn_vm_os_config
HV: replace lapic_pt with guest flag in vm_config
Mingqiang Chi (3):
hv:modulization for IO Emulation
hv: move 'setup_io_bitmap' to vm.c
hv:move ept violation handler to io_emul.c
Minggui Cao (2):
HV: check to avoid interrupt delay timer add twice
HV: modularization cleanup instr_emul header file
Li, Fei1 (28):
hv: add fast string enhanced rep movsb/stosb check on initial
hv: refine memset
hv: refine memcpy_s
hv: lib: remove memchr
hv: coding style: refine memory.c
hv: coding style: refine mmu.c
hv: coding style: refine page related
hv: coding style: remove no real declaration for external variable
hv: coding style: refine hcall_initialize_trusty to one exit
hv: coding style: refine initialize_trusty to one exit
hv: coding style: refine trusty
hv: coding style: refine find_vcpuid_entry
hv: coding style: refine set_vcpuid_entries to one exit
hv: coding style: refine cpu related function to one exit
hv: lib: refine inline assembly use in bitmap operation
hv: coding style: refine the remaining functions to one exit point
hv: Makefile: remove unused MACRO
hv: coding style: use the defined data type __packed
hv: coding style: add `const` qualifier for some function
hv: coding style: remove basic type declaration use
hv: coding style: refine functions under dm/ to one exit point
hv: inst_emul: clean the "Procedure has more than one exit point"
hv: instr_emul: refine vie_calculate_gla to void
hv: instr_emul: remove goto in get_gva_di_check
hv: instr_emul: refine decode_prefixes to one exit point
hv: instr_emul: add `const` qualifier for some function
hv: security: remove superfluous prototype
hv: coding style: remove unnecessary conditional operators
Shiqing Gao (24):
hv: vmcs: fix MISRA-C violations related to style
hv: vmcs: fix MISRA-C violations related to variable scope
hv: vmcs: fix MISRA-C violations related to pointer
hv: vmcs: fix MISRA-C violations related to multiple exits
hv: string: fix MISRA-C violations related to break
hv: string: fix MISRA-C violations related to style
hv: move `atoi` and `strtol_dec` to debug directory
hv: io: fix MISRA-C violations related to style
hv: io: fix MISRA-C violations related to multiple exits
hv: vmexit: fix MISRA-C violations related to multiple exits
hv: ept: fix MISRA-C violations
hv: cpu_state_tbl: fix multiple exits
hv: remove duplicated `is_vmx_disabled`
hv: io: fix MISRA-C violations related to break
hv: mmio_read: add `const` qualifier
doc: initial draft of ACRN coding guidelines
hv: rename register_io_emulation_handler
doc: rename register_io_emulation_handler
hv: move `dm/hw/pci.c` to `hw/pci.c`
hv: code clean-up in `hw/pci.c`
hv: vlapic: code clean-up
doc: add more rules in coding guidelines
hv: init: minor fix related to header file
hv: string: rename `s1` and `s2`
Chaohong guo (17):
HV: APICBASE_RESERVED definition is not used by any code. Just remove it
HV: move global variable into the scope of calling function
HV: remove few return statement in while loop of copy_gva function
HV: remove multiple return statement in get_vcpu_paging_mode() routine
HV: add const qualifier for functions' argments in vlapic.c
HV: trival changes to meet MISRA
HV: Remove goto statement in guest.c
HV: remove multiple exit/return in routines in the file of vlapic.c
HV: cycomatic complexity 20 in vlapic_icrlo_write_handler
HV: remove multiple exits in vlapic_set_intr_ready()
HV: Remove goto in vlapic_read()
HV: remove multi returns in vlapic_set_apicbase
HV: remove multi-returns in few routine in guest.c
HV: add empty else statement for if condition in vlapic.c
HV: misra clean for guest.c file
HV: Removed ununsed struct vm_lu_mem_map from guest.h
HV: fix MISRA issue in apicv_pending_intr()
Jason Chen CJ (17):
modulization: separate vmx.c into two parts
cleanup vmcs source and header files
modulization: vmx on/off should not use vcpu param
modulization: move functions related with cpu caps into cpu_caps.c
modulization: combine vmx_caps into cpu_caps
change get_monitor_cap to has_monitor_cap
refine in cpu_caps.c
refine apicv capability check
make detect_cpu_cap as internal function
move security related funcs into security.c
function name change in init.c
Fix Misra C violation in cpu_caps.c and security.c
Make ibrs_type as internal variable
scheduler: refine runqueue related functions
scheduler: refine make_reschedule_request
scheduler: make scheduling based on struct sched_object
init: move init_scheduler into cpu.c
Mingqiang Chi (17):
hv:refine alloc_vm_id api
hv:refine prepare_vm0 api
hv:fix MISRA-C violations in create_vm
hv:Change phys_cpu_num to static
hv:Change pcpu_active_bitmap to static
hv:Move pm state structure to pm.h
hv:Change structure boot_cpu_data to static
hv:Rename several APIs for vpic and vioapic
hv: ioapic: Change interrupt pin to uint32_t
hv: vpic: Change interrupt pin to uint32_t
hv: vioapici: Change interrupt pin to uint32_t
hv: passthrough: Change interrupt pin to uint32_t
hv: shell & vuart: Change interrupt pin to uint32_t
hv:Unify the MACRO name for invalid interrupt pin
hv:fix MISRA-C violation in multiboot.c
hv:Fix violation "Cyclomatic complexity greater than 20" in instr_emul.c
hv:Change acrn_vhm_vector to static
Zide Chen (15):
hv: MISRA-C fix "identifier reuse" in vpci code
hv: vpci: fix "Procedure has more than one exit point"
hv: refine a few functions to only one exit point
hv: vpci: fix MISRA-C violations related to variable declarations
hv: fix MISRA-C violations "Pointer param should be declared pointer to const."
hv: fix enable_msr_interception() function
hv: add missing MSRs to unsupported_msrs[]
hv: disable SMX (Safer Mode Extension) from guest CPUID
hv: disable more features from guest CPUID
hv: emulate IA32_FEATURE_CONTROL MSR
hv: fix MISRA-C violations in dm/vpci
hv: fix MISRA-C violations in vpic.c and vioapic.c
hv: fix 2 minor MISRA-C violations in inst_emul.c
hv: fix MISRA-C violations in vmsr.c
hv: add more MSR definitions
Binbin Wu (14):
dm: passthru: msi/msix handling revisit
dm: passthru: add error handling if msix table init failed
hv: ptdev: fix MISRAC violations
hv: assign: fix MISRA-C violations on implicit type conversion
hv: assign: fix MISRA-C violations on potential null pointer deference
hv: assign: fix MISRA-C violations on multiple exits
hv: assign: remove added ptirq entries if fails to add all
hv: assign: change ptirq vpin source type from enum to macro
hv: vcpuid: leaf 02h has no subleaf, delete un-needed code.
hv: vcpuid: remove unnecessary check code
hv: vcpuid: leaf 0dh is percpu related
hv: vcpuid: cpuid leaf 07h has subleaf
dm: acpi: add PSDS table in ACPI table
hv: assign: fix remaining MISRA-C violations
Huihuang Shi (14):
fix "Procedure has more than one exit point."
hv:clean io_request.c misra violations
hv: config.h fix "Nested comment found."
hv: fix e820.c violations
hv: vmcall: fix "goto detected" violations
hv: fix sprintf and hypercall violations
hv: hypercall: fix simple violations of "Procedure has more than one exit point"
hv: hypercall: fix complicated violations of "Procedure has more than one exit point"
hv: hypercall: fix "Procedure has more than one exit point"
hv: tursty_hypercall: fix "Procedure has more than one exit point"
hv: schedule: fix "Procedure has more than one exit point"
hv: clean the "Procedure has more than one exit point".
fix "goto detected:exception_inject"
hv:fix violations
Minggui Cao (14):
HV: modularization to refine pm related code.
HV: change serial PCI cfg to bus:dev.func format
HV: fix bug adapt uart mmio to bdf for HV cmdline
HV: fix pm code for multi-exits & unsigned const
DOC: change PCI uart description from mmio to bdf
HV: disable vuart when dbg uart is disabled
HV: cleanup CONFIG_COM_IRQ related code
HV: support vuart base & irq can be changed
HV: add API to change vuart base & irq config
HV: refine cmdline code, move parts into dbg_cmd
DOC: add vuart setting guide to avoid conflict
HV: modularization to refine boot/bsp related code.
HV: separate const dmar table definition from sbl
HV: modularization to separate CR related code
Tw (14):
hv:vtd: fix MISRA-C violations on scope of variable could be reduced
hv:vtd: fix MISRA-C violations on pointer param should be declared pointer to const
hv:vtd: fix MISRA-C violations on logical conjunctions need brackets
hv:vtd: fix MISRA-C violations on comment possibly contains code
hv:vtd: fix MISRA-C violations on pointer not checked for null before use
hv:vtd: fix MISRA-C violations on procedure has more than one exit point
hv:vtd: fix additional violations in vtd.c
Makefile: eliminate mistakes due to deprecated PLATFORM
Makefile: specify BOARD&FIRMWARE in sb-hypervisor-install
Makefile: add install-samples-up2
script: fix launch_uos script issue due to unseen character
config: fix no serial output with SBL on UP2
dm:script: remove ioc related stuff from uos on UP2
Makefile: support SBL binary for E2E build
Victor Sun (11):
HV: code style change for sbl_seed_parse.c
HV: code style change for abl_seed_parse.c
HV: code style change for multiboot.c
HV: code style change for reloc.c
HV: code style change for acpi.c
HV: refine vmptable for partition mode
HV: rename cb2_dnv to dnv_cb2
HV: rename dnv_cb2 to dnv-cb2
HV: rename the term of vm_description to vm_config
HV: add new acrn_vm_config member and config files
HV: remove unused mptable info
David B. Kinder (10):
doc: fix formatting in NUC GSG
doc: fix vhm_request doxygen comment
doc: add CSS for non-compliant code examples
doc: update footer copyright year
doc: spell check and formatting
doc: add skylake NUC w/GPU passthrough doc
doc: update SKL NUC patch download instructions
doc: tweak dm-parameter doc
doc: add menu option for 0.5 docs
doc: add GVT-g kernel options doc
root (8):
doc: update the doc
doc: update launch_uos.sh
doc: update the statement
doc: license header updated
doc: Descriptions about Dupont Wire used added
doc: Update the steps for generating 'partition_desc.bin'
doc: add 'checkout to release v0.5'
doc: supported KBL NUC added
yuhong.tao@intel.com (8):
hv: virq: refine vcpu_inject_vlapic_int() has more than one exit point
hv: virq: refine vcpu_inject_hi_exception()
hv: virq: refine acrn_handle_pending_request() use goto instruction
hv: virq: refine acrn_handle_pending_request() has more than one exit point
hv: virq: refine hypervisor/arch/x86/virq.c
hv: virq: fix wrong coding style
hv: virq: fix attempt to change parameter passed by value
hv:fix MISRA-C violation in virq.c
Shuo A Liu (7):
dm: Fix some issues from string operations
dm: use strnlen to replace strlen
dm: use strncpy to replace strcpy
dm: use snprintf to replace sprintf
hv: use asm_pause() to replace inline ASM to satisfy MISRAC
hv: clear NEED_RESCHEDULE flag in schedule
hv: decouple IO completion polling from idle thread
Yonghua Huang (7):
hv:fix possible buffer overflow in 'ptirq_get_intr_data()'
hv: refine coding style for ucode.c
hv: update coding style for tampoline.c
HV: [v2] bugfix in 'hv_access_memory_region_update()'
hv: remove the usage of 'atoi()'
hv: fix coding style violations in mmu.c
hv: fix coding style violations in acpi.c
Yan, Like (6):
hv: lapic: fix MISRA-C violation of potential numeric overflow
hv: irq: fix MISRA-C violations in irq.c and idt.h
hv: fix mis-usage of "PAGE_SHIFT"
hv: set/clear TMR bit like hardware behave
hv: rework EOI_EXIT_BITMAP update logic
hv: remove ACRN_REQUEST_TMR_UPDATE and unnecessary codes
Chen Gang G (5):
hv: fix violations in hkdf.c and crypto_api.c for crypto lib
hv: fix violations in sha256.c for crypto lib
hv: fix violations in md.c md.h and md_internal.h for crypto lib
hv: fix MISRAC violations for crypto lib
hv: fix identifier reuse violations in sha256.c
Geoffroy Van Cutsem (5):
Documentation: fix formatting in partition mode tutorial
Documentation: split the build instructions into its own guide
Documentation: fix highlights in launch_uos.sh script
Update doc/developer-guides/GVT-g-kernel-options.rst
Update doc/developer-guides/GVT-g-kernel-options.rst
Zhao Yakui (5):
HV/DM: Unify the usage of aligned for structure definition with alignment
DM: Try to load audio mediator BE driver before starting UOS
acrn/vhm: change the default notification vector to 0xF3
acrn/dm: Add the check of acrn_vhm/acrn_hsm to open the VHM driver
acrn/dm: Check device file of /dev/acrn_hsm to determine the path of offline VCPU
Conghui Chen (4):
dm: storage: rename delete to discard
dm: storage: support discard command
dm: virtio: refine header file
dm: virtio: fix compile issue on ubuntu
Kaige Fu (4):
HV: x86: fix "Procedure has more than one exit point"
HV: x86: fix "Global variable should be declared const"
Debug: Add one hypercall to quary hardware info
HV: x86: Fix "Variable should be declared static"
Yin Fengwei (4):
dm: flush the input/output during tty open.
dm: refine the uart_core
dm: Add teardown callback for mevent in uart_core
dm: fix the memory leak in virtio mei
Xie Zhengtian (3):
doc: modify the directories of files needed
doc: update the statement of "tag"
doc: update some statements
Liu, Xinwu (2):
tools: acrn-crashlog: Reboot system to cold after collecting reserve log
tools: acrn-crashlog: Limit the log size of kmsg
Min Lim (2):
profiling: fix the profiling tool crash by page faults
profiling: code cleanup
Peter Fang (2):
dm: vrtc: add RTC to ACPI DSDT
dm: allow PM1_RTC_EN to be written to PM1A
Sainath Grandhi (2):
hv: Write Buffer Flush - VT-d
hv: Make reserved regions in E820 table to Supervisor pages
Shuang Zheng (2):
update acrn-dm comment, remove the series of dot
Update and complete `acrn-dm` parameters description Update and complete `acrn-dm` parameters description in the user guide and HLD
Shuo Liu (2):
dm: Add vm_clear_ioreq to clear ioreq status
dm: remove unnecessary ioreq status changing from DM
Tianhua Sun (2):
security: remove gcc flags Wformat Wformat-security in HV
DM: xHCI: array bound checking before it is used
Xie, nanlin (2):
Doc: Add release note for v0.5 release.
Doc: Add one new known issue into v0.5 release note
Yuan Liu (2):
IOC mediator: fix the issue of abnormally missing tx package
DM: mei: solving the issue of closing the fd
Zhipeng Gong (2):
hv: enable/disable snoop control bit per vm
hv: hv_main: adjust vm exit trace position
Alek Du (1):
Makefile: keep files used for debug target
Arindam Roy (1):
Patch for modularising ioapic.[c/h] and related files.
Feng Tang (1):
DM: sos_bootargs: Add panic_print parameter to help debugging
Jack Ren (1):
version: 0.6-unstable
Miguel Bernal Marin (1):
Makefile: add RELEASE variable to make command
Min He (1):
script: remove DP-x:d parameters for UP2 board
Xiaoguang Wu (1):
DM USB: xHCI: change log level of some logs for S3 online debugging
huihuang.shi (1):
hv: hypercall: fix "Procedure has more than one exit point"
totoroow (1):
dm: pass mac seed not to use vm name on UP2
wenlingz (1):
Doc: Update GSG for v0.5 version and launch and acrn.conf sample script modify sbl_up2 version and scripts
Jason Chen CJ (17):
modulization: separate vmx.c into two parts
cleanup vmcs source and header files
modulization: vmx on/off should not use vcpu param
modulization: move functions related with cpu caps into cpu_caps.c
modulization: combine vmx_caps into cpu_caps
change get_monitor_cap to has_monitor_cap
refine in cpu_caps.c
refine apicv capability check
make detect_cpu_cap as internal function
move security related funcs into security.c
function name change in init.c
Fix Misra C violation in cpu_caps.c and security.c
Make ibrs_type as internal variable
scheduler: refine runqueue related functions
scheduler: refine make_reschedule_request
scheduler: make scheduling based on struct sched_object
init: move init_scheduler into cpu.c
Li, Fei1 (13):
hv: add fast string enhanced rep movsb/stosb check on initial
hv: refine memset
hv: refine memcpy_s
hv: lib: remove memchr
hv: coding style: refine memory.c
hv: coding style: refine mmu.c
hv: coding style: refine page related
hv: coding style: remove no real declaration for external variable
hv: coding style: refine hcall_initialize_trusty to one exit
hv: coding style: refine initialize_trusty to one exit
hv: coding style: refine trusty
hv: coding style: refine find_vcpuid_entry
hv: coding style: refine set_vcpuid_entries to one exit
Shiqing Gao (10):
hv: vmcs: fix MISRA-C violations related to style
hv: vmcs: fix MISRA-C violations related to variable scope
hv: vmcs: fix MISRA-C violations related to pointer
hv: vmcs: fix MISRA-C violations related to multiple exits
hv: string: fix MISRA-C violations related to break
hv: string: fix MISRA-C violations related to style
hv: move `atoi` and `strtol_dec` to debug directory
hv: io: fix MISRA-C violations related to style
hv: io: fix MISRA-C violations related to multiple exits
hv: vmexit: fix MISRA-C violations related to multiple exits
Binbin Wu (8):
dm: passthru: msi/msix handling revisit
dm: passthru: add error handling if msix table init failed
hv: ptdev: fix MISRAC violations
hv: assign: fix MISRA-C violations on implicit type conversion
hv: assign: fix MISRA-C violations on potential null pointer deference
hv: assign: fix MISRA-C violations on multiple exits
hv: assign: remove added ptirq entries if fails to add all
hv: assign: change ptirq vpin source type from enum to macro
Tw (6):
hv:vtd: fix MISRA-C violations on scope of variable could be reduced
hv:vtd: fix MISRA-C violations on pointer param should be declared pointer to const
hv:vtd: fix MISRA-C violations on logical conjunctions need brackets
hv:vtd: fix MISRA-C violations on comment possibly contains code
hv:vtd: fix MISRA-C violations on pointer not checked for null before use
hv:vtd: fix MISRA-C violations on procedure has more than one exit point
Zide Chen (6):
hv: MISRA-C fix "identifier reuse" in vpci code
hv: vpci: fix "Procedure has more than one exit point"
hv: refine a few functions to only one exit point
hv: vpci: fix MISRA-C violations related to variable declarations
hv: fix MISRA-C violations "Pointer param should be declared pointer to const."
hv: fix enable_msr_interception() function
Minggui Cao (5):
HV: modularization to refine pm related code.
HV: change serial PCI cfg to bus:dev.func format
HV: fix bug adapt uart mmio to bdf for HV cmdline
HV: fix pm code for multi-exits & unsigned const
DOC: change PCI uart description from mmio to bdf
Huihuang Shi (4):
fix "Procedure has more than one exit point."
hv:clean io_request.c misra violations
hv: config.h fix "Nested comment found."
hv: fix e820.c violations
Kaige Fu (3):
HV: x86: fix "Procedure has more than one exit point"
HV: x86: fix "Global variable should be declared const"
Debug: Add one hypercall to quary hardware info
Mingqiang Chi (3):
hv:refine alloc_vm_id api
hv:refine prepare_vm0 api
hv:fix MISRA-C violations in create_vm
Conghui Chen (2):
dm: storage: rename delete to discard
dm: storage: support discard command
Yan, Like (2):
hv: lapic: fix MISRA-C violation of potential numeric overflow
hv: irq: fix MISRA-C violations in irq.c and idt.h
Yonghua Huang (2):
hv:fix possible buffer overflow in 'ptirq_get_intr_data()'
hv: refine coding style for ucode.c
Arindam Roy (1):
Patch for modularising ioapic.[c/h] and related files.
David B. Kinder (1):
doc: fix formatting in NUC GSG
Tianhua Sun (1):
security: remove gcc flags Wformat Wformat-security in HV
Xiaoguang Wu (1):
DM USB: xHCI: change log level of some logs for S3 online debugging
Zhao Yakui (1):
HV/DM: Unify the usage of aligned for structure definition with alignment
Zhipeng Gong (1):
hv: enable/disable snoop control bit per vm
totoroow (1):
dm: pass mac seed not to use vm name on UP2
Li, Fei1 (7):
hv: fix string assigned to non const object
hv: acpi: remove weak parse_madt
hv: minimize the case of "identifier reuse"
hv: fix included file not protected with #define
hv: fix reference parameter to procedure is reassigned
hv: avoid to use "++" or "--" operators in an expression
hv: add obvious comment for empty else clause following else if
Zide Chen (3):
hv: rearrange data structure for emulated MSRs
hv: MSRs may need isolation between normal and secure world
hv: cleanup IA32_PAT emulation code r.w.t. to the refactored guest_msrs[]
Yin Fengwei (2):
dm: enhence the mevent API
dm: apply new mevent API to avoid race issue in mei
Yin, Fengwei (1):
dm: fix the race issue in mevent_del
ailin,yang (1):
DM: updating launch_uos.sh
yuhong.tao@intel.com (1):
tools: acrnctl: Fix path error when run "acrnctl add" cmd
Shiqing Gao (22):
hv: unify the function pointer assignment
hv: fix '(void) missing for discarded return value'
hv: instr_emul: clean up mmio_read/mmio_write
hv: fix integer violations
hv: fix '(void) missing for discarded return value'
hv: hv_main: clean up HV_DEBUG usage
hv: hypercall: clean up HV_DEBUG usage
hv: enhance Makefile to compile debug/release into 2 libraries
hv: ioapic: clean up HV_DEBUG usage
hv: vcpu: clean up HV_DEBUG usage
hv: irq: clean up HV_DEBUG usage
hv: vioapic: clean up HV_DEBUG usage
hv: assign: clean up HV_DEBUG usage related to shell
hv: assign: clean up HV_DEBUG usage related to vuart pin
hv: clean up function definitions in logmsg.h
hv: clean up function definitions in dump.h
hv: clean up function definitions in console.h
hv: clean up function definitions in vuart.h
hv: clean up function definitions in trace.h
hv: clean up function definitions in npk_log.h
hv: clean up function definitions in profiling.h
hv: fix 'Function return value potentially unused'
Zide Chen (12):
hv: fix MISRA-C violations in vpci code: implicit conversion
hv: fix MISRA-C violations in vpci code: 93S, 331S and 612S
hv: fix MISRA-C violations in vpci code: Function pointer is of wrong type
hv: fix 'No brackets to then/else' in vpci code
hv: PIO emulation handler is attached to I/O port number only
hv: separate the PCI CONFIG_ADDR and CONFIG_DATA I/O port handlers
hv: vpci: revert the temporary workaround of handling I/O port CF9
hv: fix 2 bugs in msix.c
hv: properly initialize MSI-X table
hv: msix: corrently determine when the guest is changing Message Data/Addr
hv: code cleanup: msr.h
hv: switch IA32_TSC_AUX between host/guest through VM Controls
Binbin Wu (11):
hv: vtd: fix the pre-allocated context table number
hv: vtd: typo fix
hv: vtd: merge lines for a statement if needed.
hv: vtd: move public API to the bottom part of the file
hv: vtd: add do_action_for_iommus
hv: vtd: check vtd enabling status with spinlock
hv: vtd: init interrupt config when resume
hv: vtd: defer dma remapping enabling until vm creation
hv: vtd: error handling revisit
doc: passthru: add structure and API docs
hv: doc: use doxygen-generated API docs in HLD for passthru
Huihuang Shi (11):
fix "Procedure is not pure assembler"
HV:pic fix "Recursion in procedure calls found"
hv: hypercall: general fix "Procedure has more than one exit point"
hv: hypercall: VM management fix "Procedure has more than one exit point"
hv: vlapic: fix "Procedure has more than one exit point"
hv: msix: fix "Procedure has more than one exit point"
hv: boot: fix "Procedure has more than one exit point"
hv: dm: fix "Procedure has more than one exit point"
hv: irq: fix "Procedure has more than one exit point"
hv: guest: fix "Procedure has more than one exit point"
hv: vpic: fix "Procedure has more than one exit point"
Li, Fei1 (8):
hv: lapic: remove union apic_lvt
hv: lapic: save lapic base MSR when suspend
hv: lapic: fix a theoretic infinite loop when clear lapic isr
hv: reloc: define data structure and MACRO when necessary
hv: include: remove name starts with underscore
hv: trusty: fix get_max_svn_index return type inconsistent
hv: instr_emul: fix decode_modrm no default case in switch statement
hv: add brackets to make operator expression more readable
Geoffroy Van Cutsem (7):
Documentation: adjust "Tracked-On" capitalization in documentation
Documentation: update GSG for release 0.3
DM: update User OS launch script with v0.3 CL and kernel numbers
Documentation: clean-up of isolated README.rst files
Documentation generation: update kernel-doc script to latest
Documentation: add a README.rst to the tools/ folder
Update 'launch_uos.sh' script for UEFI platforms
Mingqiang Chi (7):
hv:Replace dynamic memory with static for mmio
hv:Replace dynamic memory with static for ptdev
hv:Cleanup ptdev lock
hv:Add vpin to ptdev entry mapping for vpic/vioapic
hv:Revise sanitized page size
hv:Rename ptdev to ptirq for some variables and structures
hv:Rename ptdev to ptirq for some APIs
David B. Kinder (5):
doc: release notes for 0.3
doc: fix GSG version number typo
doc: add Makefile option for singlehtml
doc: tweaks to 0.3 release notes
doc: add sphinx extension improving only directive
dongshen (5):
HV: Add vuart port base address/IRQ Kconfig options
HV: For MRB, use 0x3E8/IRQ6 as the vuart port base address/IRQ.
HV: For NUC, use 0x3F8/IRQ4 as the vuart port base address/IRQ and use ttyS0 accordingly
HV: Partition mode source code file layout reorg
HV: Adding partition mode support for cb2_dnv
Qi Yadong (4):
DM: tpm emulator to communicate with swtpm
DM: Support TPM2 CRB device virtualization
DM: Add support for virtual TPM enabling
DM: build TPM2 ACPI table when TPM device enabled
Shuo Liu (4):
hv: partition mode also needs free vm id when shutdown vm
hv: reset VM ioreqs in reset_vm
dm: Fix race between ioreq client destroy and access
hv: Add IO request completion polling feature
Yonghua Huang (4):
hv:add global lock for VM & vCPU management hypercalls
hv: fix possible inconsistent issue for 'vm->hw.create_vcpus'
HV: clear memory region used by UOS before it exit
hv:use copy of guest's memory block in 'hcall_set_vm_memory_regions()'
Alexander Usyskin (3):
dm: mei: check for state before link reset callback
dm: mei: add zero termination to devpath
dm: mei: fix clients scan in sysfs
Tomas Winkler (3):
dm: mei: fix double fw_reset on uos reboot
dm: apl-mrb: launch_uos: remove mei debug flags
dm: mei: Use compare and swap primitive for refcnt.
ailin,yang (3):
Doc: update doc to support V0.3 release
HV: update kernel name
DM: update clear Linux version
Jack Ren (2):
version: v0.3
version: 0.4-unstable
Jason Chen CJ (2):
vmx: tiny fix for MACRO name and print format
modularization: boot component - move files
Kaige Fu (2):
debug: Remove early logbuf support
debug: rename struct logmsg to struct acrn_logmsg_ctl
Xie, nanlin (2):
doc: Add v0.3 release note
Doc: update new known issues and features based into v0.3 release note
Chen Gang G (1):
HV: replace dynamic memory with static for crypto library
Chen, Gang G (1):
hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox
David Kinder (1):
Update tools/README.rst
Junjie Mao (1):
HV: io: obsolete the valid field in vhm requests
Liu, Xinwu (1):
tools: acrn-crashlog: refine the log storage
Ming Liu (1):
tools: acrn-manager: set MAX_NAME_LEN to 32
Minggui Cao (1):
HV: handle adding ptdev entry failure cases
Tonny Tzeng (1):
[doc] Enhance Using partition mode on UP2 tutorial
Yin Fengwei (1):
acrn-dm: wait for monitor thread canceling finish
Yuan Liu (1):
IOC mediator: Add VehicalSteeringWheelAngle signal to the whitelist
Zheng, Gen (1):
hypervisor: use "wbinvd" carefully in RT environment
yuhong.tao@intel.com (1):
tools: acrn-manager: Fix acrnctl mistake displaying suspended to paused
zhonghua (1):
tools:acrn-crashlog:fix potential issue
Xiaoguang Wu (7):
DM USB: xHCI: refine error handling logic for ctrl transfer
DM USB: xHCI: refine the PLC bit emulation logic during S3
DM USB: xHCI: refine the xHCI S3 process
DM USB: xHCI: fix error logic of allocating xHCI slot
DM USB: xHCI: fix potential NULL pointer issue.
DM USB: refine the polling thread for libusb events
DM USB: add some preparing time for xHCI emulation before resuming.
Alexander Usyskin (3):
dm: mei: check for state before link reset callback
dm: mei: add zero termination to devpath
dm: mei: fix clients scan in sysfs
Tomas Winkler (3):
dm: mei: Use compare and swap primitive for refcnt.
dm: mei: fix double fw_reset on uos reboot
dm: apl-mrb: launch_uos: remove mei debug flags
Yin Fengwei (2):
SOS: extend the size of SOS CMA from 64M to 128M
acrn-dm: wait for monitor thread canceling finish
Shuo Liu (1):
dm: Fix race between ioreq client destroy and access
Zide Chen (3):
hv: PIO emulation handler is attached to I/O port number only
hv: separate the PCI CONFIG_ADDR and CONFIG_DATA I/O port handlers
hv: vpci: revert the temporary workaround of handling I/O port CF9
dongshen (3):
HV: Add vuart port base address/IRQ Kconfig options
HV: For MRB, use 0x3E8/IRQ6 as the vuart port base address/IRQ.
HV: For NUC, use 0x3F8/IRQ4 as the vuart port base address/IRQ and use ttyS0 accordingly
Shiqing Gao (2):
hv: fix '(void) missing for discarded return value'
hv: hv_main: clean up HV_DEBUG usage
Shuo Liu (2):
hv: partition mode also needs free vm id when shutdown vm
hv: reset VM ioreqs in reset_vm
Chen, Gang G (1):
hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox
Jason Chen CJ (1):
vmx: tiny fix for MACRO name and print format
Ming Liu (1):
tools: acrn-manager: set MAX_NAME_LEN to 32
Yonghua Huang (1):
HV: clear memory region used by UOS before it exit
Zheng, Gen (1):
hypervisor: use "wbinvd" carefully in RT environment
zhonghua (1):
tools:acrn-crashlog:fix potential issue
Shiqing Gao (2):
hv: fix '(void) missing for discarded return value'
hv: instr_emul: clean up mmio_read/mmio_write
Binbin Wu (1):
hv: vtd: fix the pre-allocated context table number
Huihuang Shi (1):
fix "Procedure is not pure assembler"
Yonghua Huang (1):
hv: fix possible inconsistent issue for 'vm->hw.create_vcpus'
Geoffroy Van Cutsem (3):
Documentation: adjust "Tracked-On" capitalization in documentation
Documentation: update GSG for release 0.3
DM: update User OS launch script with v0.3 CL and kernel numbers
David B. Kinder (2):
doc: add Makefile option for singlehtml
doc: tweaks to 0.3 release notes
Jack Ren (1):
version: 0.4-unstable
Mingqiang Chi (1):
hv:Replace dynamic memory with static for mmio
Shiqing Gao (1):
hv: unify the function pointer assignment
Yonghua Huang (1):
hv:add global lock for VM & vCPU management hypercalls
ailin,yang (3):
Doc: update doc to support V0.3 release
HV: update kernel name
DM: update clear Linux version
David B. Kinder (2):
doc: release notes for 0.3
doc: fix GSG version number typo
Xie, nanlin (2):
doc: Add v0.3 release note
Doc: update new known issues and features based into v0.3 release note
Jack Ren (1):
version: v0.3
Minggui Cao (3):
DM: add interface to set intr storm monitor params
DM: add interrupt storm monitor params in cmdline
doc: explain intr storm monitor params in acrn-dm
Shiqing Gao (2):
hv: fix 'Expression is not Boolean'
hv: fix 'Start of variable is upper case'
Zhao Yakui (2):
HV: Use parameter directly to pass bdf for hcall_assign/deassign_ptdev
DM: Fix the typo error in checking the /dev/vbs_ipu file
Binbin Wu (1):
hv: ept: set snp control when modify
Li, Fei1 (1):
hv: hypercall: remove hcall_set_vm_memory_region
Mingqiang Chi (1):
hv:Replace dynamic memory with static for port io
Victor Sun (1):
HV: add px cx data of bxt n3350 SOC
Xinyun Liu (1):
hv: fix branch addressing syntax warning
Yan, Like (1):
capture acrnd AaaG booting messages to journald
Yin Fengwei (1):
hv: fix partition mode no console issue.
yuhong.tao@intel.com (1):
dm: uart: fix UOS console output to stdin
Binbin Wu (2):
hv: pci: replace fucntion like macro with inline func
hv: vtd: use pre-defined function for bdf calculation
Li, Fei1 (1):
hv: fix a minor bug of static checks
Zhi Jin (1):
DM NPK: unmap the MMIO in pci_npk_deinit
David B. Kinder (4):
doc: update HLD Virtio Devices
doc: update HLD VM Management
doc: update HLD Power Management
doc: update HLD Trace/Log
Xiangyang Wu (3):
HV:treewide:rename vcpu data structure
HV:treewide:rename vcpu_arch data structure
HV:treewide:rename vm data structure
Yin Fengwei (2):
hypercall doc: Sync the comments for each hypercall from .h to .c
hv: fix release build issue
Binbin Wu (1):
DM: sos_bootargs: split sos_bootargs into multiple lines
Huihuang Shi (1):
fix "Casting operation to a pointer"
Manisha Chinthapally (1):
HV:debug:profiling Fixed inappropriate condition check
Mingqiang Chi (1):
hv:Remove atomic operation to set initial value for 'created_vcpu'
Shiqing Gao (1):
hv: fix integer violations
Tw (1):
hv:vtd: fix minor bug in domain count
Xinyun Liu (1):
DM/sos_bootargs: remove unused parameters for graphics
Yuan Liu (1):
IOC mediator: fix wakeup reason issue when UOS resuming
Yonghua Huang (12):
HV: wrap security related CPU capabilities checking
HV: add CPU capabilities detection for L1TF mitigation
HV: enable L1 cache flush when VM entry
HV: flush L1 cache when switching to normal world
doc: hotfix build issue blocked by l1tf.rst
doc: update l1tf.rst line endings setting to unix style
doc: format l1tf.rst
hv: revise interfaces description in vlapic
hv: revise interfaces description in vpic
hv: revise interfaces description in vioapic
hv: revise interfaces description in virq
hv:doc:use doxyen-generated API docs in HDL for vIRQ
Sainath Grandhi (10):
hv: add missing support to intercept x2APIC MSRs
hv: Modify enable_msr_interception API
hv: APIs for building x2APIC ID and LDR
hv: vLAPIC ICR write and destination mask matching for x2APIC
hv: Add APIs to convert x2APIC MSR accesses to LAPIC MMIO offset
hv: Modify vlapic_get_apicid for x2APIC mode of vLAPIC
hv: Switch APICv from MMIO to MSR for x2APIC mode of guest vLAPIC
hv: self-IPI APIC register in x2APIC mode of guest vLAPIC
hv: Add support for leaf 0xb emulation
hv: LAPIC pass-thru support for partition mode of ACRN
Li, Fei1 (9):
hv: l1tf: sanitize mapping for idle EPT
hv: mmu: add static paging table allocation for hypervisor
hv: mmu: add static paging table allocation for EPT
hv: mmu: replace dynamic memory allocation in memory
hv: mmu: remove alloc_page() API
hv: bug fix: normal world may get trusty world's pdpt page
hv: mmu: remove "##" for MISRA C
hv: mmu: add 16GB RAM support for uefi platform
hv: mmu: unmap the trusty EPT when destroy_secure_world
Zide Chen (7):
hv: Don't check multi-function flag in PCI enumeration
hv: fix bug in sizing MSI-X Table Base Address Register
hv: fix misrac violations in vcpi code
hv: MSI-X Message Address write fix
hv: fix issues when msi-x shares same BAR with other data structures
hv: enable MSI remapping on vm0
hv: resolve the negative impacts to UOS MSI/MSI-X remapping
Minggui Cao (6):
HV: fix bug "vmexit" cmd cause HV console hung
HV: add size check for shell log buffer usage
HV: change vuart port (used by SOS) to ttyS2
DM: change SOS bootargs console ttyS0 to ttyS2
HV: add main vcpu API comments for document
DOC: add main vcpu API & data structure into HLD.
Tianhua Sun (6):
tools: acrntrace: remove unsafe api and return value check for snprintf
tools: acrnlog: refine the usage of api 'snprintf'
tools: acrn-manager: refine the usage of api 'snprintf'
tools: acrn-manager: remove usage of banned APIs
tools: acrnlog: remove usage of banned APIs
tools: acrn-manager: remove unsafe api sscanf
David B. Kinder (5):
doc: hide doxygen duplicate definition warnings
doc: update Tracked-on in contribute guide
doc: fix formatting error in l1tf doc
doc: doc: update HLD Emulated Devices
doc: add doyxgen alias for easy reST inclusion
Yin Fengwei (4):
DM: set cs_limit from DM side for UOS
HV: save the cs limit field for SOS
hv: avoid hardcode cs.limit in set_vcpu_regs()
hv: Remove the up_count_spinlock and use atomic for up_count
Binbin Wu (2):
hv: vtd: add structure and API docs
hv: doc: use doxygen-generated API docs in HLD for vtd
Jason Chen CJ (2):
doc: add l1tf document
hv: vPCI needs to handle reset IO port CF9 differently
Junjie Mao (2):
HV: io: add structure and API docs
HV: doc: use doxygen-generated API docs in HLD
Shiqing Gao (2):
hv: fix integer violations
hv: use MMIO read/write APIs to access MMIO registers
Shuo Liu (2):
dm: Remove unused duplicated API dm_gpa2hva
doc: update virtio related functions doc comments
Xiangyang Wu (2):
HV:MM:add API docs
HV:doc:use doxygen-generated API docs in HLD
Geoffroy Van Cutsem (1):
Documentation: add 'make' to GSG and expand PATH for `sphinx-build`
Jian Jun Chen (1):
dm: virtio-input: ignore MSC_TIMESTAMP from guest
Liu, Xinwu (1):
tools: acrn-crashlog: fix potential issues
Mingqiang Chi (1):
hv:Replace dynamic memory with static for sbuf
Yan, Like (1):
doc: hv: add comments to irq APIs for documentation
Zhao Yakui (1):
DM:Check the device file of /dev/vbs_ipu to determine IPU mode
Junjie Mao (6):
kconfig: add more help messages to config symbols
kconfig: a faster way to check the availability of python3 package
kconfig: enforce remaking config.mk after oldconfig changes .config
kconfig: support board-specific defconfig
kconfig: use defconfig instead of default values in silentoldconfig
kconfig: optionally check if the ACPI info header is validated
Ming Liu (3):
gitignore: drop some useless entries
devicemodel: Makefile: clean up/refactor some code
devicemodel:nuc:launch_uos.sh: drop a useless clear parameter
David B. Kinder (2):
doc: fix misspellings in hld docs
doc: update rest of hypervisor HLD sections
Chang Rebecca Swee Fun (1):
sos_bootargs_release.txt: enable guc firmware loading
Minggui Cao (1):
DM: correct memory allocation size for UOS
Rebecca Chang Swee Fun (1):
sos_bootargs_debug.txt: enable guc firmware loading
Sainath Grandhi (1):
hv: switch vLAPIC mode vlapic_reset
Xiaoguang Wu (1):
DM USB: xHCI: fix process logic of TRB which has zero data length
Yonghua Huang (1):
hv: remove deprecated hypercalls
Zide Chen (10):
hv: more cleanup for pci.h
hv: minor cleanup for dm/vpci code
hv: MSI Message Address should be 64 bits
hv: change function parameters: pci_pdev_read_cfg and pci_pdev_write_cfg
hv: implement PCI bus scan function
hv: rework the MMIO handler callback hv_mem_io_handler_t arguments
hv: vpci: add callback functions to struct vpci
hv: implement msi.c to handle MSI remapping for vm0
hv: implement msix.c for MSI-X remapping
hv: implement sharing_mode.c for PCI emulation in sharing mode
Mingqiang Chi (5):
hv: Add MAX_PCPU_NUM in Kconfig
hv: Check pcpu number in Hw platform detect
hv:Check pcpu number to avoid overflow
hv:cleanup vcpu_id compare with phys_cpu_num
hv:Replace dynamic memory with static for pcpu
David B. Kinder (2):
doc: update HLD VT-d
doc: update HLD Device passthrough
Huihuang Shi (1):
fix "Recursion in procedure calls found"
Junjie Mao (1):
checkpatch: fix the line limit back to 120
Qi Yadong (1):
DM: generate random virtual RPMB key
Xinyun Liu (1):
doc: Fix AcrnGT broken API doc due to kernel upgrade
David B. Kinder (2):
doc: update HLD Timer section
doc: update HLD Virtual Interrupt
Yonghua Huang (2):
dm: fix possible buffer overflow in 'acrn_load_elf()'
DM: wrap ASSERT/DEASSERT IRQ line with Set/Clear IRQ line
Geoffroy Van Cutsem (1):
Documentation: tweak 'partition mode' tutorial
Jian Jun Chen (1):
dm: virtio-console: remove unused virtio_console_cfgwrite
Kaige Fu (1):
HV: Fix some inconsistent comments in vm_description.c
Chinthapally, Manisha (7):
HV: Added Initial support for SEP/SOCWATCH profiling
HV:Added support to get phy CPU, VM, tool information
HV:Added support to configure PMI and VM switch info
HV:Added support to perform MSR operation on all cpus
HV:Added support to get VM enter and exit information
HV:Added implementation for PMI handler function
HV:Added SBuf support to copy samples generated to guest.
David B. Kinder (6):
doc: update Memory management HLD
doc: update GRUB menu image in partition mode doc
doc: filter error exit status incorrect
doc: update I/O emulation section
doc: move docs to match HLD 0.7 org
doc: update interrupt hld section
Xiaoguang Wu (5):
DM USB: xHCI: fix issue: crash when plug device during UOS booting
DM USB: xHCI: fix bug in port unassigning function
DM USB: xHCI: fix process logic of LINK type TRB
DM USB: xHCI: refine the USB disconnect logic in DM
DM USB: xHCI: refine logic of Disable Slot Command
Yin Fengwei (5):
hv: Prepare the gdt table for VM
hv: Move the guest_sw_loader() call from vcpu to vm
DM: correct the predefine DM option string.
DM: multiboot info address in DM for elf loader is wrong.
hv: flush cache after update the trampoline code
Huihuang Shi (3):
HV:add const to bitmap_test parameter addr
HV:fix "Pointer param should be declared pointer to const"
HV:vcpu fix "Pointer param should be declared pointer to const"
Kaige Fu (3):
Documentation: Add tutorial about how to use partition mode on UP2
HV: Fix boot failure of partition mode
HV: debug: Check if vUART is configured in partition mode
Liang Yang (2):
DM USB: xHCI: Fix a potential NULL pointer issue.
DM USB: xHCI: Fix an potential array out of range issue.
Manisha Chinthapally (2):
HV:Added support to setup tool & start/stop profing
Fix to kernel hang in smp_call_function
Binbin Wu (1):
dm: bios: update vSBL to v1.0
CHEN Gang (1):
tools: acrn-crashlog: update the documents
Conghui Chen (1):
dm: cmdline: remove unused parameters
Jian Jun Chen (1):
dm: virtio: remove unused vbs_kernel_init
Mingqiang Chi (1):
hv:Remove deadcode 'vm_lapic_from_pcpuid'
Sainath Grandhi (1):
hv: x2apic support for acrn
Yonghua Huang (1):
hv: fix mapping between GSI Num#2 and PIC IRQ #0
Zhi Jin (1):
samples: enable pstore via the sos kernel cmdline
xiaojin2 (1):
tools: acrn-crashlog: remove unsafe apis in usercrash
Liu, Xinwu (7):
tools: acrn-crashlog: new api in strutils
tools: acrn-crashlog: remove unsafe apis from android_events.c
tools: acrn-crashlog: remove unsafe api sprintf
tools: acrn-crashlog: remove unsafe api sscanf
tools: acrn-crashlog: refine the configuration structure
tools: acrn-crashlog: update string operation in acrnprobe
tools: acrn-crashlog: remove unsafe strlen in common
Xiaoguang Wu (5):
DM USB: introduce function usb_get_native_devinfo
DM USB: xHCI: change port mapping logic for multiple hub support
DM USB: add support for multi-layers hubs
DM USB: xHCI: fix incorrect device searching logic
DM USB: xHCI: workaround for Stop Endpoint Command handling
David B. Kinder (3):
doc: update HLD overview chapter
doc: HV startup and CPU virtualization sections
doc: merge static core with cpu virt
Kaige Fu (3):
tools: acrnd: Refine log msg to avoid confusing.
tools: acrnd: check weakup reason first in init_vm
tools: acrnd: Ignore null line reading from timer_list
Liang Yang (3):
DM USB: xHCI: remove old hub support code.
DM USB: introduce struct usb_devpath and releted functions
DM USB: xHCI: support multiple hubs in single layer
Yan, Like (2):
tools: acrn-manager: fix a potential NULL pointer dereference
tools: acrn-manager: fix a potential compiler warning
Huang, Yang (1):
dm: rpmb: DM customized changes for RPMB mux kernel module
Huihuang Shi (1):
HV:fixed "Pointer param should be declared pointer to const"
Shuo Liu (1):
[REVERTME] dm: script: disable xHCI runtime PM to WA USB role switch hang issue
Victor Sun (1):
HV: move default ACPI info to default_acpi_info.h
Yonghua Huang (1):
hv: fix potential buffer overflow in vpic_set_pinstate()
Yin Fengwei (14):
hv: add function to reset vcpu registers
hv: add function to set AP entry
hv: Update SOS BSP to use new API to init BSP state
hv: Add function to set UOS BSP init state
hv: simplify the function init_guest_state
hv: add hypercall to set vcpu init state
dm: add API to set vcpu regs of guest
dm: update the vsbl loader
dm: update the bzimage loader
hv: remove the vm loader for UOS in hv.
hv: not start vm automatically when reset vm
dm: add call to set BSP init state for UOS S3 and system reset
hv: Cleanup: set vcpu mode in vcpu_set_regs
hv: Cleanup: Remove dead code.
Tomas Winkler (4):
dm: inline functions defined in header must be static
dm: mevent: remove useless vmname global variable
dm: mevent: implement enable/disable functions
dm: mevent: add edge triggered events.
Binbin Wu (3):
dm: passthru: enable pba emulation for msix
dm: passthru: add deinit_msix_table
dm: passthru: fix hardcoded nhlt table length
Peter Fang (3):
dm: storage: remove GEOM support
dm: virtio: add debugging information in virtio-blk
dm: virtio: reject requests that violate the virtio-block spec
Huihuang Shi (2):
use genld.sh to generate link_ram.ld
customize function to generate config.h with proper suffixes
Mingqiang Chi (2):
hv:Remove CONFIG_VM0_DESC
hv:Replace dynamic memory with static for vcpu
Wei Liu (2):
dm: cleanup the cmd options for acrn-dm
hv: add suffix(U/UL) to come up MISRA-C into include
Yan, Like (2):
tools: acrn-manager: fix fd leaking
tools: acrn-manager: remove assumption of fd num less than 1024
Yonghua Huang (2):
hv: fix NULL pointer dereference in "hcall_set_vm_memory_regions()"
hv:enable APICv-Posted Interrupt
Yu Wang (2):
hv: virq: update apicv irr/rvi before handle vmcs event injection
dm: passthru: correct the name of xdci dsdt write function
David B. Kinder (1):
doc: add static core partitioning doc
Jason Chen CJ (1):
vpic: change assert/deassert method
Jian Jun Chen (1):
dm: virtio: use the correct register size
Junjie Mao (1):
kconfig patch
Min He (1):
script: re-enable PVMMIO ppgtt update optimization for GVT-g
Minggui Cao (1):
HV: allow no IRR when pending bit set if no APIC-V
Shiqing Gao (1):
hv: fix 'No brackets to then/else'
Yang, Yu-chu (1):
HV: get tss address from per cpu data
Yuan Liu (1):
dm: uart: fix acrn-dm crash issue
Zhao Yakui (1):
Revert "DM: Disable plane_restriction on 4.19 kernel"
junjunshan1 (1):
hv: Fix identifier reuse