commit	78a9cd650a709a87dd36f146ab38853bbe6de0b3	[log] [tgz]
author	Chun-Hung Wu <chun-hung.wu@mediatek.com>	Wed May 12 16:50:16 2021 +0800
committer	Todd Kjos <tkjos@google.com>	Tue May 25 19:45:10 2021 +0000
tree	b50527dc4d92f86e9cc4bd69d6ebdfa4250affb2
parent	4b280e66ee7d7a8f82a5e50082e9531f7fc9306c [diff]

ANDROID: add initial symbol list for mtk

1. Generated with:
  ./extract_symbols --whitelist abi_gki_aarch64_mtk --skip-module-grouping target_ko_path/
2. update mtk entry in build.config.gki.aarch64
Leaf changes summary: 233 artifacts changed
Changed leaf types summary: 0 leaf type changed
Removed/Changed/Added functions summary: 0 Removed, 0 Changed, 207 Added functions
Removed/Changed/Added variables summary: 0 Removed, 0 Changed, 26 Added variables

Leaf changes summary: 233 artifacts changed
Changed leaf types summary: 0 leaf type changed
Removed/Changed/Added functions summary: 0 Removed, 0 Changed, 207 Added functions
Removed/Changed/Added variables summary: 0 Removed, 0 Changed, 26 Added variables

207 Added functions:

  [A] 'function int __iio_device_register(iio_dev*, module*)'
  [A] 'function int __kfifo_to_user(__kfifo*, void*, unsigned long int, unsigned int*)'
  [A] 'function int __trace_puts(unsigned long int, const char*, int)'
  [A] 'function int __traceiter_android_rvh_find_busiest_group(void*, sched_group*, rq*, int*)'
  [A] 'function int __traceiter_android_rvh_finish_prio_fork(void*, task_struct*)'
  [A] 'function int __traceiter_android_rvh_prepare_prio_fork(void*, task_struct*)'
  [A] 'function int __traceiter_android_rvh_rtmutex_prepare_setprio(void*, task_struct*, task_struct*)'
  [A] 'function int __traceiter_android_rvh_set_user_nice(void*, task_struct*, long int*, bool*)'
  [A] 'function int __traceiter_android_rvh_setscheduler(void*, task_struct*)'
  [A] 'function int __traceiter_android_vh_alter_futex_plist_add(void*, plist_node*, plist_head*, bool*)'
  [A] 'function int __traceiter_android_vh_alter_rwsem_list_add(void*, rwsem_waiter*, rw_semaphore*, bool*)'
  [A] 'function int __traceiter_android_vh_cgroup_set_task(void*, int, task_struct*)'
  [A] 'function int __traceiter_android_vh_em_cpu_energy(void*, em_perf_domain*, unsigned long int, unsigned long int, unsigned long int*)'
  [A] 'function int __traceiter_android_vh_rwsem_init(void*, rw_semaphore*)'
  [A] 'function int __traceiter_android_vh_rwsem_wake(void*, rw_semaphore*)'
  [A] 'function int __traceiter_android_vh_rwsem_write_finished(void*, rw_semaphore*)'
  [A] 'function int __traceiter_android_vh_set_wake_flags(void*, int*, unsigned int*)'
  [A] 'function int __traceiter_android_vh_syscall_prctl_finished(void*, int, task_struct*)'
  [A] 'function int __v4l2_ctrl_s_ctrl(v4l2_ctrl*, s32)'
  [A] 'function int _raw_read_trylock(rwlock_t*)'
  [A] 'function void alarm_start(alarm*, ktime_t)'
  [A] 'function int bitmap_find_free_region(unsigned long int*, unsigned int, int)'
  [A] 'function void bitmap_free(const unsigned long int*)'
  [A] 'function unsigned long int* bitmap_zalloc(unsigned int, gfp_t)'
  [A] 'function void cfg80211_cac_event(net_device*, const cfg80211_chan_def*, nl80211_radar_event, gfp_t)'
  [A] 'function unsigned int cfg80211_classify8021d(sk_buff*, cfg80211_qos_map*)'
  [A] 'function void cfg80211_radar_event(wiphy*, cfg80211_chan_def*, gfp_t)'
  [A] 'function clk* clk_register_composite(device*, const char*, const char* const*, int, clk_hw*, const clk_ops*, clk_hw*, const clk_ops*, clk_hw*, const clk_ops*, unsigned long int)'
  [A] 'function clk* clk_register_divider_table(device*, const char*, const char*, unsigned long int, void*, u8, u8, u8, const clk_div_table*, spinlock_t*)'
  [A] 'function void cpu_hotplug_disable()'
  [A] 'function void cpu_hotplug_enable()'
  [A] 'function void cpufreq_unregister_governor(cpufreq_governor*)'
  [A] 'function void cpuidle_driver_state_disabled(cpuidle_driver*, int, bool)'
  [A] 'function cpuidle_driver* cpuidle_get_driver()'
  [A] 'function void cpuidle_pause_and_lock()'
  [A] 'function void cpuidle_resume_and_unlock()'
  [A] 'function int dapm_clock_event(snd_soc_dapm_widget*, snd_kcontrol*, int)'
  [A] 'function unsigned int dapm_kcontrol_get_value(const snd_kcontrol*)'
  [A] 'function int debug_locks_off()'
  [A] 'function void debugfs_create_devm_seqfile(device*, const char*, dentry*, int (seq_file*, void*)*)'
  [A] 'function dev_pm_opp* dev_pm_opp_find_freq_ceil_by_volt(device*, unsigned long int)'
  [A] 'function int dev_pm_opp_of_add_table_indexed(device*, int)'
  [A] 'function devfreq* devfreq_get_devfreq_by_phandle(device*, const char*, int)'
  [A] 'function unsigned int device_get_child_node_count(device*)'
  [A] 'function void device_link_remove(void*, device*)'
  [A] 'function int device_rename(device*, const char*)'
  [A] 'function void device_set_of_node_from_dev(device*, const device*)'
  [A] 'function void devm_devfreq_remove_device(device*, devfreq*)'
  [A] 'function pwm_device* devm_fwnode_pwm_get(device*, fwnode_handle*, const char*)'
  [A] 'function void devm_gpiod_put(device*, gpio_desc*)'
  [A] 'function void devm_led_classdev_unregister(device*, led_classdev*)'
  [A] 'function phy* devm_of_phy_get_by_index(device*, device_node*, int)'
  [A] 'function power_supply* devm_power_supply_get_by_phandle(device*, const char*)'
  [A] 'function void devm_regulator_unregister_notifier(regulator*, notifier_block*)'
  [A] 'function int drm_atomic_helper_legacy_gamma_set(drm_crtc*, u16*, u16*, u16*, uint32_t, drm_modeset_acquire_ctx*)'
  [A] 'function int drm_atomic_helper_resume(drm_device*, drm_atomic_state*)'
  [A] 'function drm_atomic_state* drm_atomic_helper_suspend(drm_device*)'
  [A] 'function void drm_calc_timestamping_constants(drm_crtc*, const drm_display_mode*)'
  [A] 'function int drm_gem_dumb_destroy(drm_file*, drm_device*, uint32_t)'
  [A] 'function em_perf_domain* em_cpu_get(int)'
  [A] 'function int em_dev_register_perf_domain(device*, unsigned int, em_data_callback*, cpumask_t*, bool)'
  [A] 'function int eth_header(sk_buff*, net_device*, unsigned short int, void*, void*, unsigned int)'
  [A] 'function int eth_header_cache(const neighbour*, hh_cache*, __be16)'
  [A] 'function void eth_header_cache_update(hh_cache*, const net_device*, const unsigned char*)'
  [A] 'function int eth_header_parse(const sk_buff*, unsigned char*)'
  [A] 'function pid* find_pid_ns(int, pid_namespace*)'
  [A] 'function int follow_pfn(vm_area_struct*, unsigned long int, unsigned long int*)'
  [A] 'function void for_each_kernel_tracepoint(void (tracepoint*, void*)*, void*)'
  [A] 'function int freq_qos_add_notifier(freq_constraints*, freq_qos_req_type, notifier_block*)'
  [A] 'function int get_kernel_pages(const kvec*, int, int, page**)'
  [A] 'function void iio_buffer_init(iio_buffer*)'
  [A] 'function void iio_buffer_put(iio_buffer*)'
  [A] 'function iio_channel* iio_channel_get(device*, const char*)'
  [A] 'function void iio_channel_release(iio_channel*)'
  [A] 'function void iio_device_attach_buffer(iio_dev*, iio_buffer*)'
  [A] 'function int iio_get_channel_type(iio_channel*, iio_chan_type*)'
  [A] 'function s64 iio_get_time_ns(const iio_dev*)'
  [A] 'function int iio_push_to_buffers(iio_dev*, void*)'
  [A] 'function int iio_read_channel_attribute(iio_channel*, int*, int*, iio_chan_info_enum)'
  [A] 'function int iio_read_channel_raw(iio_channel*, int*)'
  [A] 'function int kernfs_path_from_node(kernfs_node*, kernfs_node*, char*, size_t)'
  [A] 'function kobject* kset_find_obj(kset*, const char*)'
  [A] 'function int led_get_flash_fault(led_classdev_flash*, u32*)'
  [A] 'function int led_set_brightness_sync(led_classdev*, led_brightness)'
  [A] 'function int led_set_flash_brightness(led_classdev_flash*, u32)'
  [A] 'function int led_set_flash_timeout(led_classdev_flash*, u32)'
  [A] 'function void led_sysfs_disable(led_classdev*)'
  [A] 'function void led_sysfs_enable(led_classdev*)'
  [A] 'function void led_trigger_remove(led_classdev*)'
  [A] 'function int led_update_brightness(led_classdev*)'
  [A] 'function int led_update_flash_brightness(led_classdev_flash*)'
  [A] 'function ssize_t mipi_dsi_generic_write(mipi_dsi_device*, void*, size_t)'
  [A] 'function int mod_timer_pending(timer_list*, unsigned long int)'
  [A] 'function int mutex_lock_killable(mutex*)'
  [A] 'function int n_tty_ioctl_helper(tty_struct*, file*, unsigned int, unsigned long int)'
  [A] 'function void* netdev_alloc_frag(unsigned int)'
  [A] 'function int nf_register_net_hooks(net*, const nf_hook_ops*, unsigned int)'
  [A] 'function void nf_unregister_net_hooks(net*, const nf_hook_ops*, unsigned int)'
  [A] 'function nvmem_device* nvmem_device_get(device*, const char*)'
  [A] 'function dma_chan* of_dma_xlate_by_chan_id(of_phandle_args*, of_dma*)'
  [A] 'function backlight_device* of_find_backlight_by_node(device_node*)'
  [A] 'function int of_genpd_add_device(of_phandle_args*, device*)'
  [A] 'function int of_irq_to_resource_table(device_node*, resource*, int)'
  [A] 'function int of_remove_property(device_node*, property*)'
  [A] 'function int param_get_bool(char*, const kernel_param*)'
  [A] 'function int param_get_charp(char*, const kernel_param*)'
  [A] 'function int param_get_ulong(char*, const kernel_param*)'
  [A] 'function int param_set_charp(const char*, const kernel_param*)'
  [A] 'function int param_set_ulong(const char*, const kernel_param*)'
  [A] 'function phy* phy_get(device*, const char*)'
  [A] 'function void phy_put(device*, phy*)'
  [A] 'function int pinconf_generic_parse_dt_config(device_node*, pinctrl_dev*, unsigned long int**, unsigned int*)'
  [A] 'function int pinctrl_gpio_direction_input(unsigned int)'
  [A] 'function int pinctrl_gpio_direction_output(unsigned int)'
  [A] 'function int pinctrl_utils_add_map_configs(pinctrl_dev*, pinctrl_map**, unsigned int*, unsigned int*, const char*, unsigned long int*, unsigned int, pinctrl_map_type)'
  [A] 'function int pinctrl_utils_reserve_map(pinctrl_dev*, pinctrl_map**, unsigned int*, unsigned int*, unsigned int)'
  [A] 'function void platform_unregister_drivers(platform_driver* const*, unsigned int)'
  [A] 'function int pm_genpd_add_device(generic_pm_domain*, device*)'
  [A] 'function int pm_genpd_remove_device(device*)'
  [A] 'function bool pm_suspend_default_s2idle()'
  [A] 'function void rcu_idle_enter()'
  [A] 'function void rcu_idle_exit()'
  [A] 'function device* rdev_get_dev(regulator_dev*)'
  [A] 'function int regulator_list_voltage(regulator*, unsigned int)'
  [A] 'function int regulator_map_voltage_iterate(regulator_dev*, int, int)'
  [A] 'function int regulator_map_voltage_linear_range(regulator_dev*, int, int)'
  [A] 'function int regulator_set_voltage_time(regulator*, int, int)'
  [A] 'function int regulator_set_voltage_time_sel(regulator_dev*, unsigned int, unsigned int)'
  [A] 'function int regulator_sync_voltage(regulator*)'
  [A] 'function int remove_proc_subtree(const char*, proc_dir_entry*)'
  [A] 'function int reset_controller_register(reset_controller_dev*)'
  [A] 'function rpmsg_endpoint* rpmsg_create_ept(rpmsg_device*, rpmsg_rx_cb_t, void*, rpmsg_channel_info)'
  [A] 'function void rpmsg_destroy_ept(rpmsg_endpoint*)'
  [A] 'function rtc_time rtc_ktime_to_tm(ktime_t)'
  [A] 'function int rtc_nvmem_register(rtc_device*, nvmem_config*)'
  [A] 'function ktime_t rtc_tm_to_ktime(rtc_time)'
  [A] 'function unsigned long int schedutil_cpu_util(int, unsigned long int, unsigned long int, schedutil_type, task_struct*)'
  [A] 'function int sdio_claim_irq(sdio_func*, sdio_irq_handler_t*)'
  [A] 'function u8 sdio_readb(sdio_func*, unsigned int, int*)'
  [A] 'function u32 sdio_readl(sdio_func*, unsigned int, int*)'
  [A] 'function int sdio_release_irq(sdio_func*)'
  [A] 'function void sdio_writeb(sdio_func*, u8, unsigned int, int*)'
  [A] 'function void sdio_writel(sdio_func*, u32, unsigned int, int*)'
  [A] 'function int send_sig(int, task_struct*, int)'
  [A] 'function int seq_open_private(file*, const seq_operations*, int)'
  [A] 'function void serial8250_do_set_termios(uart_port*, ktermios*, ktermios*)'
  [A] 'function void serial8250_do_shutdown(uart_port*)'
  [A] 'function int serial8250_do_startup(uart_port*)'
  [A] 'function uart_8250_port* serial8250_get_port(int)'
  [A] 'function int serial8250_register_8250_port(uart_8250_port*)'
  [A] 'function void serial8250_resume_port(int)'
  [A] 'function void serial8250_rpm_get(uart_8250_port*)'
  [A] 'function void serial8250_rpm_put(uart_8250_port*)'
  [A] 'function void serial8250_suspend_port(int)'
  [A] 'function void serial8250_unregister_port(int)'
  [A] 'function void* skb_pull_rcsum(sk_buff*, unsigned int)'
  [A] 'function void snd_pcm_lib_preallocate_pages_for_all(snd_pcm*, int, void*, size_t, size_t)'
  [A] 'function int snd_soc_poweroff(device*)'
  [A] 'function int snd_soc_resume(device*)'
  [A] 'function void suspend_set_ops(const platform_suspend_ops*)'
  [A] 'function regmap* syscon_regmap_lookup_by_compatible(const char*)'
  [A] 'function void syscore_resume()'
  [A] 'function int syscore_suspend()'
  [A] 'function void tty_driver_flush_buffer(tty_struct*)'
  [A] 'function int tty_register_ldisc(int, tty_ldisc_ops*)'
  [A] 'function int tty_unregister_ldisc(int)'
  [A] 'function void* typec_mux_get_drvdata(typec_mux*)'
  [A] 'function typec_mux* typec_mux_register(device*, const typec_mux_desc*)'
  [A] 'function void typec_mux_unregister(typec_mux*)'
  [A] 'function int typec_partner_set_identity(typec_partner*)'
  [A] 'function int typec_set_orientation(typec_port*, typec_orientation)'
  [A] 'function void typec_set_vconn_role(typec_port*, typec_role)'
  [A] 'function unsigned int uart_get_divisor(uart_port*, unsigned int)'
  [A] 'function void ufshcd_delay_us(unsigned long int, unsigned long int)'
  [A] 'function int ufshcd_hba_enable(ufs_hba*)'
  [A] 'function int ufshcd_link_recovery(ufs_hba*)'
  [A] 'function int ufshcd_make_hba_operational(ufs_hba*)'
  [A] 'function void unpin_user_pages(page**, unsigned long int)'
  [A] 'function usb_hcd* usb_create_shared_hcd(const hc_driver*, device*, const char*, usb_hcd*)'
  [A] 'function int usb_gadget_map_request(usb_gadget*, usb_request*, int)'
  [A] 'function void usb_gadget_unmap_request(usb_gadget*, usb_request*, int)'
  [A] 'function v4l2_async_subdev* v4l2_async_notifier_add_fwnode_subdev(v4l2_async_notifier*, fwnode_handle*, unsigned int)'
  [A] 'function void v4l2_async_notifier_init(v4l2_async_notifier*)'
  [A] 'function int v4l2_async_notifier_register(v4l2_device*, v4l2_async_notifier*)'
  [A] 'function void v4l2_async_notifier_unregister(v4l2_async_notifier*)'
  [A] 'function int v4l2_async_register_subdev(v4l2_subdev*)'
  [A] 'function void v4l2_async_unregister_subdev(v4l2_subdev*)'
  [A] 'function int v4l2_ctrl_subscribe_event(v4l2_fh*, const v4l2_event_subscription*)'
  [A] 'function int v4l2_fh_is_singular(v4l2_fh*)'
  [A] 'function void v4l2_m2m_buf_remove_by_buf(v4l2_m2m_queue_ctx*, vb2_v4l2_buffer*)'
  [A] 'function int v4l2_m2m_ioctl_create_bufs(file*, void*, v4l2_create_buffers*)'
  [A] 'function int v4l2_m2m_ioctl_expbuf(file*, void*, v4l2_exportbuffer*)'
  [A] 'function int v4l2_m2m_ioctl_prepare_buf(file*, void*, v4l2_buffer*)'
  [A] 'function int v4l2_m2m_ioctl_qbuf(file*, void*, v4l2_buffer*)'
  [A] 'function void v4l2_m2m_resume(v4l2_m2m_dev*)'
  [A] 'function void v4l2_m2m_suspend(v4l2_m2m_dev*)'
  [A] 'function int v4l2_src_change_event_subscribe(v4l2_fh*, const v4l2_event_subscription*)'
  [A] 'function int vsprintf(char*, const char*, va_list)'
  [A] 'function long int work_on_cpu(int, long int (void*)*, void*)'
  [A] 'function int xhci_check_bandwidth(usb_hcd*, usb_device*)'
  [A] 'function int xhci_drop_endpoint(usb_hcd*, usb_device*, usb_host_endpoint*)'
  [A] 'function void xhci_reset_bandwidth(usb_hcd*, usb_device*)'
  [A] 'function int zlib_deflate(z_streamp, int)'
  [A] 'function int zlib_deflateEnd(z_streamp)'
  [A] 'function int zlib_deflateInit2(z_streamp, int, int, int, int, int)'
  [A] 'function int zlib_deflateReset(z_streamp)'
  [A] 'function int zlib_deflate_workspacesize(int, int)'

26 Added variables:

  [A] 'tracepoint __tracepoint_android_rvh_find_busiest_group'
  [A] 'tracepoint __tracepoint_android_rvh_finish_prio_fork'
  [A] 'tracepoint __tracepoint_android_rvh_prepare_prio_fork'
  [A] 'tracepoint __tracepoint_android_rvh_rtmutex_prepare_setprio'
  [A] 'tracepoint __tracepoint_android_rvh_set_user_nice'
  [A] 'tracepoint __tracepoint_android_rvh_setscheduler'
  [A] 'tracepoint __tracepoint_android_vh_alter_futex_plist_add'
  [A] 'tracepoint __tracepoint_android_vh_alter_rwsem_list_add'
  [A] 'tracepoint __tracepoint_android_vh_cgroup_set_task'
  [A] 'tracepoint __tracepoint_android_vh_em_cpu_energy'
  [A] 'tracepoint __tracepoint_android_vh_rwsem_init'
  [A] 'tracepoint __tracepoint_android_vh_rwsem_wake'
  [A] 'tracepoint __tracepoint_android_vh_rwsem_write_finished'
  [A] 'tracepoint __tracepoint_android_vh_set_wake_flags'
  [A] 'tracepoint __tracepoint_android_vh_syscall_prctl_finished'
  [A] 'const clk_ops clk_divider_ops'
  [A] 'const clk_ops clk_gate_ops'
  [A] 'const clk_ops clk_mux_ops'
  [A] 'rwlock_t dev_base_lock'
  [A] 'const font_desc font_vga_8x16'
  [A] 'const char hex_asc[17]'
  [A] 'neigh_table nd_tbl'
  [A] 'workqueue_struct* pm_wq'
  [A] 'bus_type spi_bus_type'
  [A] 'workqueue_struct* system_freezable_power_efficient_wq'
  [A] 'const vb2_mem_ops vb2_dma_contig_memops'

Bug: 149040612
Change-Id: I1af3902f42555ea002f3c6cb9979bc231b51e427
Signed-off-by: Chun-Hung Wu <chun-hung.wu@mediatek.com>

3 files changed

tree: b50527dc4d92f86e9cc4bd69d6ebdfa4250affb2

README.md

How do I submit patches to Android Common Kernels

BEST: Make all of your changes to upstream Linux. If appropriate, backport to the stable releases. These patches will be merged automatically in the corresponding common kernels. If the patch is already in upstream Linux, post a backport of the patch that conforms to the patch requirements below.
- Do not send patches upstream that contain only symbol exports. To be considered for upstream Linux, additions of EXPORT_SYMBOL_GPL() require an in-tree modular driver that uses the symbol -- so include the new driver or changes to an existing driver in the same patchset as the export.
- When sending patches upstream, the commit message must contain a clear case for why the patch is needed and beneficial to the community. Enabling out-of-tree drivers or functionality is not not a persuasive case.
LESS GOOD: Develop your patches out-of-tree (from an upstream Linux point-of-view). Unless these are fixing an Android-specific bug, these are very unlikely to be accepted unless they have been coordinated with kernel-team@android.com. If you want to proceed, post a patch that conforms to the patch requirements below.

Common Kernel patch requirements

All patches must conform to the Linux kernel coding standards and pass script/checkpatch.pl
Patches shall not break gki_defconfig or allmodconfig builds for arm, arm64, x86, x86_64 architectures (see https://source.android.com/setup/build/building-kernels)
If the patch is not merged from an upstream branch, the subject must be tagged with the type of patch: UPSTREAM:, BACKPORT:, FROMGIT:, FROMLIST:, or ANDROID:.
All patches must have a Change-Id: tag (see https://gerrit-review.googlesource.com/Documentation/user-changeid.html)
If an Android bug has been assigned, there must be a Bug: tag.
All patches must have a Signed-off-by: tag by the author and the submitter

Additional requirements are listed below based on patch type

Requirements for backports from mainline Linux: `UPSTREAM:`, `BACKPORT:`

If the patch is a cherry-pick from Linux mainline with no changes at all
- tag the patch subject with UPSTREAM:.
- add upstream commit information with a (cherry picked from commit ...) line
- Example:
  - if the upstream commit message is

        important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

then Joe Smith would upload the patch for the common kernel as

        UPSTREAM: important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

        Bug: 135791357
        Change-Id: I4caaaa566ea080fa148c5e768bb1a0b6f7201c01
        (cherry picked from commit c31e73121f4c1ec41143423ac6ce3ce6dafdcec1)
        Signed-off-by: Joe Smith <joe.smith@foo.org>

If the patch requires any changes from the upstream version, tag the patch with BACKPORT: instead of UPSTREAM:.
- use the same tags as UPSTREAM:
- add comments about the changes under the (cherry picked from commit ...) line
- Example:

        BACKPORT: important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

        Bug: 135791357
        Change-Id: I4caaaa566ea080fa148c5e768bb1a0b6f7201c01
        (cherry picked from commit c31e73121f4c1ec41143423ac6ce3ce6dafdcec1)
        [joe: Resolved minor conflict in drivers/foo/bar.c ]
        Signed-off-by: Joe Smith <joe.smith@foo.org>

Requirements for other backports: `FROMGIT:`, `FROMLIST:`,

If the patch has been merged into an upstream maintainer tree, but has not yet been merged into Linux mainline
- tag the patch subject with FROMGIT:
- add info on where the patch came from as (cherry picked from commit <sha1> <repo> <branch>). This must be a stable maintainer branch (not rebased, so don't use linux-next for example).
- if changes were required, use BACKPORT: FROMGIT:
- Example:
  - if the commit message in the maintainer tree is

        important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

then Joe Smith would upload the patch for the common kernel as

        FROMGIT: important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

        Bug: 135791357
        (cherry picked from commit 878a2fd9de10b03d11d2f622250285c7e63deace
         https://git.kernel.org/pub/scm/linux/kernel/git/foo/bar.git test-branch)
        Change-Id: I4caaaa566ea080fa148c5e768bb1a0b6f7201c01
        Signed-off-by: Joe Smith <joe.smith@foo.org>

If the patch has been submitted to LKML, but not accepted into any maintainer tree
- tag the patch subject with FROMLIST:
- add a Link: tag with a link to the submittal on lore.kernel.org
- add a Bug: tag with the Android bug (required for patches not accepted into a maintainer tree)
- if changes were required, use BACKPORT: FROMLIST:
- Example:

        FROMLIST: important patch from upstream

        This is the detailed description of the important patch

        Signed-off-by: Fred Jones <fred.jones@foo.org>

        Bug: 135791357
        Link: https://lore.kernel.org/lkml/20190619171517.GA17557@someone.com/
        Change-Id: I4caaaa566ea080fa148c5e768bb1a0b6f7201c01
        Signed-off-by: Joe Smith <joe.smith@foo.org>

Requirements for Android-specific patches: `ANDROID:`

If the patch is fixing a bug to Android-specific code
- tag the patch subject with ANDROID:
- add a Fixes: tag that cites the patch with the bug
- Example:

        ANDROID: fix android-specific bug in foobar.c

        This is the detailed description of the important fix

        Fixes: 1234abcd2468 ("foobar: add cool feature")
        Change-Id: I4caaaa566ea080fa148c5e768bb1a0b6f7201c01
        Signed-off-by: Joe Smith <joe.smith@foo.org>

If the patch is a new feature
- tag the patch subject with ANDROID:
- add a Bug: tag with the Android bug (required for android-specific features)

How do I submit patches to Android Common Kernels

Common Kernel patch requirements

Requirements for backports from mainline Linux: UPSTREAM:, BACKPORT:

Requirements for other backports: FROMGIT:, FROMLIST:,

Requirements for Android-specific patches: ANDROID:

Requirements for backports from mainline Linux: `UPSTREAM:`, `BACKPORT:`

Requirements for other backports: `FROMGIT:`, `FROMLIST:`,

Requirements for Android-specific patches: `ANDROID:`