mirror of
https://github.com/linux-msm/laptops-kernel.git
synced 2026-08-13 14:19:53 -07:00
drm: Fix typo in comments
fix typo for drm v1->v2: respin with the change "iff ==> implies that" Signed-off-by: Cai Huoqing <caihuoqing@baidu.com> Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch> Link: https://patchwork.freedesktop.org/patch/msgid/20210730132729.376-1-caihuoqing@baidu.com
This commit is contained in:
committed by
Daniel Vetter
parent
33e1fc0624
commit
0ae865ef92
@@ -78,7 +78,7 @@
|
||||
*
|
||||
* Drivers that are susceptible to being removed by other drivers, such as
|
||||
* generic EFI or VESA drivers, have to register themselves as owners of their
|
||||
* given framebuffer memory. Ownership of the framebuffer memory is achived
|
||||
* given framebuffer memory. Ownership of the framebuffer memory is achieved
|
||||
* by calling devm_aperture_acquire_from_firmware(). On success, the driver
|
||||
* is the owner of the framebuffer range. The function fails if the
|
||||
* framebuffer is already by another driver. See below for an example.
|
||||
|
||||
@@ -723,7 +723,7 @@ static void drm_atomic_plane_print_state(struct drm_printer *p,
|
||||
* clocks, scaler units, bandwidth and fifo limits shared among a group of
|
||||
* planes or CRTCs, and so on) it makes sense to model these as independent
|
||||
* objects. Drivers then need to do similar state tracking and commit ordering for
|
||||
* such private (since not exposed to userpace) objects as the atomic core and
|
||||
* such private (since not exposed to userspace) objects as the atomic core and
|
||||
* helpers already provide for connectors, planes and CRTCs.
|
||||
*
|
||||
* To make this easier on drivers the atomic core provides some support to track
|
||||
|
||||
@@ -634,7 +634,7 @@ drm_atomic_helper_check_modeset(struct drm_device *dev,
|
||||
* connectors and a NULL mode.
|
||||
*
|
||||
* The other way around is true as well. enable != 0
|
||||
* iff connectors are attached and a mode is set.
|
||||
* implies that connectors are attached and a mode is set.
|
||||
*/
|
||||
new_crtc_state->mode_changed = true;
|
||||
new_crtc_state->connectors_changed = true;
|
||||
@@ -1686,7 +1686,7 @@ static void commit_work(struct work_struct *work)
|
||||
}
|
||||
|
||||
/**
|
||||
* drm_atomic_helper_async_check - check if state can be commited asynchronously
|
||||
* drm_atomic_helper_async_check - check if state can be committed asynchronously
|
||||
* @dev: DRM device
|
||||
* @state: the driver state object
|
||||
*
|
||||
@@ -1695,7 +1695,7 @@ static void commit_work(struct work_struct *work)
|
||||
* but just do in-place changes on the current state.
|
||||
*
|
||||
* It will return 0 if the commit can happen in an asynchronous fashion or error
|
||||
* if not. Note that error just mean it can't be commited asynchronously, if it
|
||||
* if not. Note that error just mean it can't be committed asynchronously, if it
|
||||
* fails the commit should be treated like a normal synchronous commit.
|
||||
*/
|
||||
int drm_atomic_helper_async_check(struct drm_device *dev,
|
||||
@@ -2583,7 +2583,7 @@ EXPORT_SYMBOL(drm_atomic_helper_commit_planes);
|
||||
*
|
||||
* This function can only be savely used when planes are not allowed to move
|
||||
* between different CRTCs because this function doesn't handle inter-CRTC
|
||||
* depencies. Callers need to ensure that either no such depencies exist,
|
||||
* dependencies. Callers need to ensure that either no such dependencies exist,
|
||||
* resolve them through ordering of commit calls or through some other means.
|
||||
*/
|
||||
void
|
||||
@@ -2720,7 +2720,7 @@ EXPORT_SYMBOL(drm_atomic_helper_cleanup_planes);
|
||||
/**
|
||||
* drm_atomic_helper_swap_state - store atomic state into current sw state
|
||||
* @state: atomic state
|
||||
* @stall: stall for preceeding commits
|
||||
* @stall: stall for preceding commits
|
||||
*
|
||||
* This function stores the atomic state into the current state pointers in all
|
||||
* driver objects. It should be called after all failing steps have been done
|
||||
|
||||
@@ -48,7 +48,7 @@
|
||||
* in all its forms: The monster ATOMIC IOCTL itself, code for GET_PROPERTY and
|
||||
* SET_PROPERTY IOCTLs. Plus interface functions for compatibility helpers and
|
||||
* drivers which have special needs to construct their own atomic updates, e.g.
|
||||
* for load detect or similiar.
|
||||
* for load detect or similar.
|
||||
*/
|
||||
|
||||
/**
|
||||
@@ -753,7 +753,7 @@ static int drm_atomic_connector_set_property(struct drm_connector *connector,
|
||||
* restore the state it wants on VT switch. So if the userspace
|
||||
* tries to change the link_status from GOOD to BAD, driver
|
||||
* silently rejects it and returns a 0. This prevents userspace
|
||||
* from accidently breaking the display when it restores the
|
||||
* from accidentally breaking the display when it restores the
|
||||
* state.
|
||||
*/
|
||||
if (state->link_status != DRM_LINK_STATUS_GOOD)
|
||||
@@ -1064,7 +1064,7 @@ int drm_atomic_set_property(struct drm_atomic_state *state,
|
||||
* DOC: explicit fencing properties
|
||||
*
|
||||
* Explicit fencing allows userspace to control the buffer synchronization
|
||||
* between devices. A Fence or a group of fences are transfered to/from
|
||||
* between devices. A Fence or a group of fences are transferred to/from
|
||||
* userspace using Sync File fds and there are two DRM properties for that.
|
||||
* IN_FENCE_FD on each DRM Plane to send fences to the kernel and
|
||||
* OUT_FENCE_PTR on each DRM CRTC to receive fences from the kernel.
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
*
|
||||
* In addition only one &drm_master can be the current master for a &drm_device.
|
||||
* It can be switched through the DROP_MASTER and SET_MASTER IOCTL, or
|
||||
* implicitly through closing/openeing the primary device node. See also
|
||||
* implicitly through closing/opening the primary device node. See also
|
||||
* drm_is_current_master().
|
||||
*
|
||||
* Clients can authenticate against the current master (if it matches their own)
|
||||
|
||||
@@ -982,7 +982,7 @@ drm_atomic_bridge_propagate_bus_flags(struct drm_bridge *bridge,
|
||||
bridge_state->output_bus_cfg.flags = output_flags;
|
||||
|
||||
/*
|
||||
* Propage the output flags to the input end of the bridge. Again, it's
|
||||
* Propagate the output flags to the input end of the bridge. Again, it's
|
||||
* not necessarily what all bridges want, but that's what most of them
|
||||
* do, and by doing that by default we avoid forcing drivers to
|
||||
* duplicate the "dummy propagation" logic.
|
||||
|
||||
@@ -1502,7 +1502,7 @@ int drm_legacy_freebufs(struct drm_device *dev, void *data,
|
||||
*
|
||||
* Maps the AGP, SG or PCI buffer region with vm_mmap(), and copies information
|
||||
* about each buffer into user space. For PCI buffers, it calls vm_mmap() with
|
||||
* offset equal to 0, which drm_mmap() interpretes as PCI buffers and calls
|
||||
* offset equal to 0, which drm_mmap() interprets as PCI buffers and calls
|
||||
* drm_mmap_dma().
|
||||
*/
|
||||
int __drm_legacy_mapbufs(struct drm_device *dev, void *data, int *p,
|
||||
|
||||
@@ -170,7 +170,7 @@ drm_clflush_virt_range(void *addr, unsigned long length)
|
||||
for (; addr < end; addr += size)
|
||||
clflushopt(addr);
|
||||
clflushopt(end - 1); /* force serialisation */
|
||||
mb(); /*Ensure that evry data cache line entry is flushed*/
|
||||
mb(); /*Ensure that every data cache line entry is flushed*/
|
||||
return;
|
||||
}
|
||||
|
||||
|
||||
@@ -116,7 +116,7 @@ int drm_atomic_helper_dirtyfb(struct drm_framebuffer *fb,
|
||||
int ret = 0;
|
||||
|
||||
/*
|
||||
* When called from ioctl, we are interruptable, but not when called
|
||||
* When called from ioctl, we are interruptible, but not when called
|
||||
* internally (ie. defio worker)
|
||||
*/
|
||||
drm_modeset_acquire_init(&ctx,
|
||||
|
||||
@@ -772,7 +772,7 @@ int drm_dp_downstream_max_tmds_clock(const u8 dpcd[DP_RECEIVER_CAP_SIZE],
|
||||
* It's left up to the driver to check the
|
||||
* DP dual mode adapter's max TMDS clock.
|
||||
*
|
||||
* Unfortunatley it looks like branch devices
|
||||
* Unfortunately it looks like branch devices
|
||||
* may not fordward that the DP dual mode i2c
|
||||
* access so we just usually get i2c nak :(
|
||||
*/
|
||||
@@ -1365,7 +1365,7 @@ static int drm_dp_i2c_msg_duration(const struct drm_dp_aux_msg *msg,
|
||||
}
|
||||
|
||||
/*
|
||||
* Deterine how many retries should be attempted to successfully transfer
|
||||
* Determine how many retries should be attempted to successfully transfer
|
||||
* the specified message, based on the estimated durations of the
|
||||
* i2c and AUX transfers.
|
||||
*/
|
||||
@@ -1418,7 +1418,7 @@ static int drm_dp_i2c_do_msg(struct drm_dp_aux *aux, struct drm_dp_aux_msg *msg)
|
||||
/*
|
||||
* While timeouts can be errors, they're usually normal
|
||||
* behavior (for instance, when a driver tries to
|
||||
* communicate with a non-existant DisplayPort device).
|
||||
* communicate with a non-existent DisplayPort device).
|
||||
* Avoid spamming the kernel log with timeout errors.
|
||||
*/
|
||||
if (ret == -ETIMEDOUT)
|
||||
@@ -3329,7 +3329,7 @@ drm_edp_backlight_probe_max(struct drm_dp_aux *aux, struct drm_edp_backlight_inf
|
||||
fxp = DIV_ROUND_CLOSEST(1000 * DP_EDP_BACKLIGHT_FREQ_BASE_KHZ, driver_pwm_freq_hz);
|
||||
|
||||
/* Use highest possible value of Pn for more granularity of brightness adjustment while
|
||||
* satifying the conditions below.
|
||||
* satisfying the conditions below.
|
||||
* - Pn is in the range of Pn_min and Pn_max
|
||||
* - F is in the range of 1 and 255
|
||||
* - FxP is within 25% of desired value.
|
||||
|
||||
@@ -249,7 +249,7 @@ void drm_minor_release(struct drm_minor *minor)
|
||||
* Finally when everything is up and running and ready for userspace the device
|
||||
* instance can be published using drm_dev_register().
|
||||
*
|
||||
* There is also deprecated support for initalizing device instances using
|
||||
* There is also deprecated support for initializing device instances using
|
||||
* bus-specific helpers and the &drm_driver.load callback. But due to
|
||||
* backwards-compatibility needs the device instance have to be published too
|
||||
* early, which requires unpretty global locking to make safe and is therefore
|
||||
@@ -379,7 +379,7 @@ void drm_minor_release(struct drm_minor *minor)
|
||||
* shortcoming however, drm_dev_unplug() marks the drm_device as unplugged before
|
||||
* drm_atomic_helper_shutdown() is called. This means that if the disable code
|
||||
* paths are protected, they will not run on regular driver module unload,
|
||||
* possibily leaving the hardware enabled.
|
||||
* possibly leaving the hardware enabled.
|
||||
*/
|
||||
|
||||
/**
|
||||
|
||||
@@ -98,7 +98,7 @@ void drm_dsc_pps_payload_pack(struct drm_dsc_picture_parameter_set *pps_payload,
|
||||
{
|
||||
int i;
|
||||
|
||||
/* Protect against someone accidently changing struct size */
|
||||
/* Protect against someone accidentally changing struct size */
|
||||
BUILD_BUG_ON(sizeof(*pps_payload) !=
|
||||
DP_SDP_PPS_HEADER_PAYLOAD_BYTES_MINUS_1 + 1);
|
||||
|
||||
|
||||
@@ -1919,7 +1919,7 @@ EXPORT_SYMBOL(drm_add_override_edid_modes);
|
||||
* level, drivers must make all reasonable efforts to expose it as an I2C
|
||||
* adapter and use drm_get_edid() instead of abusing this function.
|
||||
*
|
||||
* The EDID may be overridden using debugfs override_edid or firmare EDID
|
||||
* The EDID may be overridden using debugfs override_edid or firmware EDID
|
||||
* (drm_load_edid_firmware() and drm.edid_firmware parameter), in this priority
|
||||
* order. Having either of them bypasses actual EDID reads.
|
||||
*
|
||||
@@ -5906,7 +5906,7 @@ drm_hdmi_vendor_infoframe_from_display_mode(struct hdmi_vendor_infoframe *frame,
|
||||
* (ie.vic==0 and s3d_struct==0) we will still send it if we
|
||||
* know that the sink can handle it. This is based on a
|
||||
* suggestion in HDMI 2.0 Appendix F. Apparently some sinks
|
||||
* have trouble realizing that they shuld switch from 3D to 2D
|
||||
* have trouble realizing that they should switch from 3D to 2D
|
||||
* mode if the source simply stops sending the infoframe when
|
||||
* it wants to switch from 3D to 2D.
|
||||
*/
|
||||
|
||||
@@ -565,7 +565,7 @@ struct fb_info *drm_fb_helper_alloc_fbi(struct drm_fb_helper *fb_helper)
|
||||
goto err_release;
|
||||
|
||||
/*
|
||||
* TODO: We really should be smarter here and alloc an apperture
|
||||
* TODO: We really should be smarter here and alloc an aperture
|
||||
* for each IORESOURCE_MEM resource helper->dev->dev has and also
|
||||
* init the ranges of the appertures based on the resources.
|
||||
* Note some drivers currently count on there being only 1 empty
|
||||
|
||||
@@ -405,7 +405,7 @@ static int drm_open_helper(struct file *filp, struct drm_minor *minor)
|
||||
*
|
||||
* RETURNS:
|
||||
*
|
||||
* 0 on success or negative errno value on falure.
|
||||
* 0 on success or negative errno value on failure.
|
||||
*/
|
||||
int drm_open(struct inode *inode, struct file *filp)
|
||||
{
|
||||
@@ -548,7 +548,7 @@ EXPORT_SYMBOL(drm_release_noglobal);
|
||||
* @offset: offset to read
|
||||
*
|
||||
* This function must be used by drivers as their &file_operations.read
|
||||
* method iff they use DRM events for asynchronous signalling to userspace.
|
||||
* method if they use DRM events for asynchronous signalling to userspace.
|
||||
* Since events are used by the KMS API for vblank and page flip completion this
|
||||
* means all modern display drivers must use it.
|
||||
*
|
||||
@@ -641,7 +641,7 @@ EXPORT_SYMBOL(drm_read);
|
||||
* @wait: poll waiter table
|
||||
*
|
||||
* This function must be used by drivers as their &file_operations.read method
|
||||
* iff they use DRM events for asynchronous signalling to userspace. Since
|
||||
* if they use DRM events for asynchronous signalling to userspace. Since
|
||||
* events are used by the KMS API for vblank and page flip completion this means
|
||||
* all modern display drivers must use it.
|
||||
*
|
||||
|
||||
@@ -412,7 +412,7 @@ EXPORT_SYMBOL(drm_fb_blit_rect_dstclip);
|
||||
* of the display and the framebuffer mismatch, the copy function will
|
||||
* attempt to convert between them.
|
||||
*
|
||||
* See drm_fb_blit_rect_dstclip() for more inforamtion.
|
||||
* See drm_fb_blit_rect_dstclip() for more information.
|
||||
*
|
||||
* Returns:
|
||||
* 0 on success, or a negative error code otherwise.
|
||||
|
||||
@@ -1110,7 +1110,7 @@ void drm_framebuffer_remove(struct drm_framebuffer *fb)
|
||||
|
||||
/*
|
||||
* drm ABI mandates that we remove any deleted framebuffers from active
|
||||
* useage. But since most sane clients only remove framebuffers they no
|
||||
* usage. But since most sane clients only remove framebuffers they no
|
||||
* longer need, try to optimize this away.
|
||||
*
|
||||
* Since we're holding a reference ourselves, observing a refcount of 1
|
||||
|
||||
@@ -901,7 +901,7 @@ err:
|
||||
}
|
||||
|
||||
/**
|
||||
* drm_gem_open - initalizes GEM file-private structures at devnode open time
|
||||
* drm_gem_open - initializes GEM file-private structures at devnode open time
|
||||
* @dev: drm_device which is being opened by userspace
|
||||
* @file_private: drm file-private structure to set up
|
||||
*
|
||||
@@ -936,7 +936,7 @@ drm_gem_release(struct drm_device *dev, struct drm_file *file_private)
|
||||
* drm_gem_object_release - release GEM buffer object resources
|
||||
* @obj: GEM buffer object
|
||||
*
|
||||
* This releases any structures and resources used by @obj and is the invers of
|
||||
* This releases any structures and resources used by @obj and is the inverse of
|
||||
* drm_gem_object_init().
|
||||
*/
|
||||
void
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
*
|
||||
* The helpers for shadow-buffered planes establish and release mappings,
|
||||
* and provide struct drm_shadow_plane_state, which stores the plane's mapping
|
||||
* for commit-tail functons.
|
||||
* for commit-tail functions.
|
||||
*
|
||||
* Shadow-buffered planes can easily be enabled by using the provided macros
|
||||
* %DRM_GEM_SHADOW_PLANE_FUNCS and %DRM_GEM_SHADOW_PLANE_HELPER_FUNCS.
|
||||
@@ -374,7 +374,7 @@ EXPORT_SYMBOL(drm_gem_prepare_shadow_fb);
|
||||
* This function implements struct &drm_plane_helper_funcs.cleanup_fb.
|
||||
* This function unmaps all buffer objects of the plane's framebuffer.
|
||||
*
|
||||
* See drm_gem_prepare_shadow_fb() for more inforamtion.
|
||||
* See drm_gem_prepare_shadow_fb() for more information.
|
||||
*/
|
||||
void drm_gem_cleanup_shadow_fb(struct drm_plane *plane, struct drm_plane_state *plane_state)
|
||||
{
|
||||
|
||||
@@ -368,7 +368,7 @@ static void drm_gem_shmem_vunmap_locked(struct drm_gem_shmem_object *shmem,
|
||||
}
|
||||
|
||||
/*
|
||||
* drm_gem_shmem_vunmap - Unmap a virtual mapping fo a shmem GEM object
|
||||
* drm_gem_shmem_vunmap - Unmap a virtual mapping for a shmem GEM object
|
||||
* @shmem: shmem GEM object
|
||||
* @map: Kernel virtual address where the SHMEM GEM object was mapped
|
||||
*
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user