All of lore.kernel.org
 help / color / mirror / Atom feed
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, rodrigo.vivi@intel.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, michal.simek@xilinx.com,
	melissa.srw@gmail.com, linux-tegra@vger.kernel.org,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	linux@armlinux.org.uk, mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com,
	linux-rockchip@lists.infradead.org,
	linux-mediatek@lists.infradead.org, wens@csie.org,
	jernej.skrabec@gmail.com, jonathanh@nvidia.com,
	xinliang.liu@linaro.org, kong.kongxinwei@hisilicon.com,
	james.qian.wang@arm.com, linux-imx@nxp.com,
	Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	intel-gfx@lists.freedesktop.org, bskeggs@redhat.com,
	chunkuang.hu@kernel.org, puck.chen@hisilicon.com,
	s.hauer@pengutronix.de, rodrigosiqueiramelo@gmail.com,
	laurentiu.palcu@oss.nxp.com, matthias.bgg@gmail.com,
	kernel@pengutronix.de, linux-arm-kernel@lists.infradead.org,
	mcoquelin.stm32@gmail.com, amd-gfx@lists.freedesktop.org,
	hyun.kwon@xilinx.com, tomba@kernel.org, jyri.sarha@iki.fi,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	christian.koenig@amd.com, linux-sunxi@lists.linux.dev,
	kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, alexander.deucher@amd.com,
	tiantao6@hisilicon.com, shawnguo@kernel.org
Subject: Re: [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, laurentiu.palcu@oss.nxp.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, linux@armlinux.org.uk,
	melissa.srw@gmail.com, matthias.bgg@gmail.com,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com, tomba@kernel.org,
	michal.simek@xilinx.com, jernej.skrabec@gmail.com,
	linux-rockchip@lists.infradead.org, wens@csie.org,
	james.qian.wang@arm.com, linux-imx@nxp.com,
	xinliang.liu@linaro.org, linux-graphics-maintainer@vmware.com,
	kong.kongxinwei@hisilicon.com, s.hauer@pengutronix.de,
	bskeggs@redhat.com, chunkuang.hu@kernel.org,
	mcoquelin.stm32@gmail.com, puck.chen@hisilicon.com,
	intel-gfx@lists.freedesktop.org,
	linux-mediatek@lists.infradead.org, rodrigo.vivi@intel.com,
	linux-tegra@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	amd-gfx@lists.freedesktop.org, hyun.kwon@xilinx.com,
	rodrigosiqueiramelo@gmail.com, shawnguo@kernel.org,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	linux-sunxi@lists.linux.dev, kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, kernel@pengutronix.de,
	alexander.deucher@amd.com, tiantao6@hisilicon.com,
	jyri.sarha@iki.fi, christian.koenig@amd.com
Subject: Re: [Nouveau] [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #1.2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

[-- Attachment #2: Type: text/plain, Size: 154 bytes --]

_______________________________________________
Nouveau mailing list
Nouveau@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/nouveau

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, rodrigo.vivi@intel.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, michal.simek@xilinx.com,
	melissa.srw@gmail.com, linux-tegra@vger.kernel.org,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	linux@armlinux.org.uk, mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com,
	linux-rockchip@lists.infradead.org,
	linux-mediatek@lists.infradead.org, wens@csie.org,
	jernej.skrabec@gmail.com, jonathanh@nvidia.com,
	xinliang.liu@linaro.org, kong.kongxinwei@hisilicon.com,
	james.qian.wang@arm.com, linux-imx@nxp.com,
	Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	intel-gfx@lists.freedesktop.org, bskeggs@redhat.com,
	chunkuang.hu@kernel.org, puck.chen@hisilicon.com,
	s.hauer@pengutronix.de, rodrigosiqueiramelo@gmail.com,
	laurentiu.palcu@oss.nxp.com, matthias.bgg@gmail.com,
	kernel@pengutronix.de, linux-arm-kernel@lists.infradead.org,
	mcoquelin.stm32@gmail.com, amd-gfx@lists.freedesktop.org,
	hyun.kwon@xilinx.com, tomba@kernel.org, jyri.sarha@iki.fi,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	christian.koenig@amd.com, linux-sunxi@lists.linux.dev,
	kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, alexander.deucher@amd.com,
	tiantao6@hisilicon.com, shawnguo@kernel.org
Subject: Re: [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #1.2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

[-- Attachment #2: Type: text/plain, Size: 170 bytes --]

_______________________________________________
Linux-rockchip mailing list
Linux-rockchip@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-rockchip

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, rodrigo.vivi@intel.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, michal.simek@xilinx.com,
	melissa.srw@gmail.com, linux-tegra@vger.kernel.org,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	linux@armlinux.org.uk, mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com,
	linux-rockchip@lists.infradead.org,
	linux-mediatek@lists.infradead.org, wens@csie.org,
	jernej.skrabec@gmail.com, jonathanh@nvidia.com,
	xinliang.liu@linaro.org, kong.kongxinwei@hisilicon.com,
	james.qian.wang@arm.com, linux-imx@nxp.com,
	Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	intel-gfx@lists.freedesktop.org, bskeggs@redhat.com,
	chunkuang.hu@kernel.org, puck.chen@hisilicon.com,
	s.hauer@pengutronix.de, rodrigosiqueiramelo@gmail.com,
	laurentiu.palcu@oss.nxp.com, matthias.bgg@gmail.com,
	kernel@pengutronix.de, linux-arm-kernel@lists.infradead.org,
	mcoquelin.stm32@gmail.com, amd-gfx@lists.freedesktop.org,
	hyun.kwon@xilinx.com, tomba@kernel.org, jyri.sarha@iki.fi,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	christian.koenig@amd.com, linux-sunxi@lists.linux.dev,
	kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, alexander.deucher@amd.com,
	tiantao6@hisilicon.com, shawnguo@kernel.org
Subject: Re: [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #1.2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

[-- Attachment #2: Type: text/plain, Size: 170 bytes --]

_______________________________________________
Linux-mediatek mailing list
Linux-mediatek@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-mediatek

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, laurentiu.palcu@oss.nxp.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, linux@armlinux.org.uk,
	melissa.srw@gmail.com, matthias.bgg@gmail.com,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com, tomba@kernel.org,
	michal.simek@xilinx.com, jernej.skrabec@gmail.com,
	jonathanh@nvidia.com, linux-rockchip@lists.infradead.org,
	wens@csie.org, james.qian.wang@arm.com, linux-imx@nxp.com,
	xinliang.liu@linaro.org, Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	kong.kongxinwei@hisilicon.com, s.hauer@pengutronix.de,
	bskeggs@redhat.com, chunkuang.hu@kernel.org,
	mcoquelin.stm32@gmail.com, puck.chen@hisilicon.com,
	intel-gfx@lists.freedesktop.org,
	linux-mediatek@lists.infradead.org, rodrigo.vivi@intel.com,
	linux-tegra@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	amd-gfx@lists.freedesktop.org, hyun.kwon@xilinx.com,
	rodrigosiqueiramelo@gmail.com, shawnguo@kernel.org,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	linux-sunxi@lists.linux.dev, kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, kernel@pengutronix.de,
	alexander.deucher@amd.com, tiantao6@hisilicon.com,
	jyri.sarha@iki.fi, christian.koenig@amd.com
Subject: Re: [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, laurentiu.palcu@oss.nxp.com,
	alexandre.torgue@foss.st.com, dri-devel@lists.freedesktop.org,
	linux@armlinux.org.uk, melissa.srw@gmail.com,
	matthias.bgg@gmail.com, laurent.pinchart@ideasonboard.com,
	benjamin.gaignard@linaro.org, mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com, tomba@kernel.org,
	michal.simek@xilinx.com, jernej.skrabec@gmail.com,
	jonathanh@nvidia.com, linux-rockchip@lists.infradead.org,
	wens@csie.org, james.qian.wang@arm.com, linux-imx@nxp.com,
	xinliang.liu@linaro.org, Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	kong.kongxinwei@hisilicon.com, s.hauer@pengutronix.de,
	bskeggs@redhat.com, chunkuang.hu@kernel.org,
	mcoquelin.stm32@gmail.com, puck.chen@hisilicon.com,
	intel-gfx@lists.freedesktop.org,
	linux-mediatek@lists.infradead.org, linux-tegra@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	amd-gfx@lists.freedesktop.org, hyun.kwon@xilinx.com,
	rodrigosiqueiramelo@gmail.com, shawnguo@kernel.org,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	linux-sunxi@lists.linux.dev, kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, kernel@pengutronix.de,
	alexander.deucher@amd.com, tiantao6@hisilicon.com,
	jyri.sarha@iki.fi, christian.koenig@amd.com
Subject: Re: [Intel-gfx] [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #1.2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

[-- Attachment #2: Type: text/plain, Size: 160 bytes --]

_______________________________________________
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

WARNING: multiple messages have this Message-ID (diff)
From: Thomas Zimmermann <tzimmermann@suse.de>
To: Jani Nikula <jani.nikula@linux.intel.com>,
	Thierry Reding <thierry.reding@gmail.com>
Cc: hamohammed.sa@gmail.com, emma@anholt.net, airlied@linux.ie,
	nouveau@lists.freedesktop.org, laurentiu.palcu@oss.nxp.com,
	liviu.dudau@arm.com, alexandre.torgue@foss.st.com,
	dri-devel@lists.freedesktop.org, linux@armlinux.org.uk,
	melissa.srw@gmail.com, matthias.bgg@gmail.com,
	laurent.pinchart@ideasonboard.com, benjamin.gaignard@linaro.org,
	mihail.atanassov@arm.com,
	linux-stm32@st-md-mailman.stormreply.com,
	linux-samsung-soc@vger.kernel.org, jy0922.shim@samsung.com,
	krzysztof.kozlowski@canonical.com, tomba@kernel.org,
	michal.simek@xilinx.com, jernej.skrabec@gmail.com,
	jonathanh@nvidia.com, linux-rockchip@lists.infradead.org,
	wens@csie.org, james.qian.wang@arm.com, linux-imx@nxp.com,
	xinliang.liu@linaro.org, Daniel Vetter <daniel.vetter@ffwll.ch>,
	linux-graphics-maintainer@vmware.com,
	kong.kongxinwei@hisilicon.com, s.hauer@pengutronix.de,
	bskeggs@redhat.com, chunkuang.hu@kernel.org,
	mcoquelin.stm32@gmail.com, puck.chen@hisilicon.com,
	intel-gfx@lists.freedesktop.org,
	linux-mediatek@lists.infradead.org, rodrigo.vivi@intel.com,
	linux-tegra@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	amd-gfx@lists.freedesktop.org, hyun.kwon@xilinx.com,
	rodrigosiqueiramelo@gmail.com, shawnguo@kernel.org,
	yannick.fertre@foss.st.com, Xinhui.Pan@amd.com,
	sw0312.kim@samsung.com, hjc@rock-chips.com,
	linux-sunxi@lists.linux.dev, kyungmin.park@samsung.com,
	kieran.bingham+renesas@ideasonboard.com,
	philippe.cornu@foss.st.com, kernel@pengutronix.de,
	alexander.deucher@amd.com, tiantao6@hisilicon.com,
	jyri.sarha@iki.fi, christian.koenig@amd.com
Subject: Re: [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls
Date: Thu, 24 Jun 2021 14:57:44 +0200	[thread overview]
Message-ID: <0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de> (raw)
In-Reply-To: <87zgvfsalz.fsf@intel.com>


[-- Attachment #1.1.1: Type: text/plain, Size: 3127 bytes --]

Hi

Am 24.06.21 um 14:36 schrieb Jani Nikula:
> On Thu, 24 Jun 2021, Thierry Reding <thierry.reding@gmail.com> wrote:
>> On Thu, Jun 24, 2021 at 11:07:57AM +0200, Thomas Zimmermann wrote:
>>> Hi
>>>
>>> Am 24.06.21 um 10:51 schrieb Jani Nikula:
>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>> Hi
>>>>>
>>>>> Am 24.06.21 um 10:06 schrieb Jani Nikula:
>>>>>> On Thu, 24 Jun 2021, Thomas Zimmermann <tzimmermann@suse.de> wrote:
>>>>>>> diff --git a/drivers/gpu/drm/drm_vblank.c b/drivers/gpu/drm/drm_vblank.c
>>>>>>> index 3417e1ac7918..10fe16bafcb6 100644
>>>>>>> --- a/drivers/gpu/drm/drm_vblank.c
>>>>>>> +++ b/drivers/gpu/drm/drm_vblank.c
>>>>>>> @@ -1748,8 +1748,16 @@ int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
>>>>>>>     	unsigned int pipe_index;
>>>>>>>     	unsigned int flags, pipe, high_pipe;
>>>>>>> -	if (!dev->irq_enabled)
>>>>>>> -		return -EOPNOTSUPP;
>>>>>>> +#if defined(CONFIG_DRM_LEGACY)
>>>>>>> +	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY))) {
>>>>>>> +		if (!dev->irq_enabled)
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	} else /* if DRIVER_MODESET */
>>>>>>> +#endif
>>>>>>> +	{
>>>>>>> +		if (!drm_dev_has_vblank(dev))
>>>>>>> +			return -EOPNOTSUPP;
>>>>>>> +	}
>>>>>>
>>>>>> Sheesh I hate this kind of inline #ifdefs.
>>>>>>
>>>>>> Two alternate suggestions that I believe should be as just efficient:
>>>>>
>>>>> Or how about:
>>>>>
>>>>> static bool drm_wait_vblank_supported(struct drm_device *dev)
>>>>>
>>>>> {
>>>>>
>>>>> if defined(CONFIG_DRM_LEGACY)
>>>>> 	if  (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>>>>>
>>>>> 		return dev->irq_enabled;
>>>>>
>>>>> #endif
>>>>> 	return drm_dev_has_vblank(dev);
>>>>>
>>>>> }
>>>>>
>>>>>
>>>>> ?
>>>>>
>>>>> It's inline, but still readable.
>>>>
>>>> It's definitely better than the original, but it's unclear to me why
>>>> you'd prefer this over option 2) below. I guess the only reason I can
>>>> think of is emphasizing the conditional compilation. However,
>>>> IS_ENABLED() is widely used in this manner specifically to avoid inline
>>>> #if, and the compiler optimizes it away.
>>>
>>> It's simply more readable to me as the condition is simpler. But option 2 is
>>> also ok.
>>
>> Perhaps do something like this, then:
>>
>> 	if (IS_ENABLED(CONFIG_DRM_LEGACY)) {
>> 		if (unlikely(drm_core_check_feature(dev, DRIVER_LEGACY)))
>> 			return dev->irq_enabled;
>> 	}
>>
>> 	return drm_dev_has_vblank(dev);
>>
>> That's about just as readable as the variant involving the preprocessor
>> but has all the benefits of not using the preprocessor.
> 
> Looks like a winner to me. :)

That's the most readable.

But I just remembered that irq_enabled will likely become legacy-only in 
the device structure. We'll need an ifdef variant then. :/

Best regards
Thomas

> 
> BR,
> Jani.
> 
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer


[-- Attachment #1.2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 840 bytes --]

[-- Attachment #2: Type: text/plain, Size: 154 bytes --]

_______________________________________________
amd-gfx mailing list
amd-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/amd-gfx

  reply	other threads:[~2021-06-24 12:57 UTC|newest]

Thread overview: 260+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-24  7:28 [PATCH v3 00/27] Deprecate struct drm_device.irq_enabled Thomas Zimmermann
2021-06-24  7:28 ` Thomas Zimmermann
2021-06-24  7:28 ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28 ` Thomas Zimmermann
2021-06-24  7:28 ` Thomas Zimmermann
2021-06-24  7:28 ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 01/27] drm/amdgpu: Track IRQ state in local device state Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 02/27] drm/hibmc: Call drm_irq_uninstall() unconditionally Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 03/27] drm/radeon: Track IRQ state in local device state Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 04/27] drm: Don't test for IRQ support in VBLANK ioctls Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  8:06   ` Jani Nikula
2021-06-24  8:06     ` Jani Nikula
2021-06-24  8:06     ` [Intel-gfx] " Jani Nikula
2021-06-24  8:06     ` Jani Nikula
2021-06-24  8:06     ` Jani Nikula
2021-06-24  8:06     ` [Nouveau] " Jani Nikula
2021-06-24  8:19     ` Thomas Zimmermann
2021-06-24  8:19       ` Thomas Zimmermann
2021-06-24  8:19       ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  8:19       ` Thomas Zimmermann
2021-06-24  8:19       ` Thomas Zimmermann
2021-06-24  8:19       ` [Nouveau] " Thomas Zimmermann
2021-06-24  8:28     ` Thomas Zimmermann
2021-06-24  8:28       ` Thomas Zimmermann
2021-06-24  8:28       ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  8:28       ` Thomas Zimmermann
2021-06-24  8:28       ` Thomas Zimmermann
2021-06-24  8:28       ` [Nouveau] " Thomas Zimmermann
2021-06-24  8:51       ` Jani Nikula
2021-06-24  8:51         ` Jani Nikula
2021-06-24  8:51         ` [Intel-gfx] " Jani Nikula
2021-06-24  8:51         ` Jani Nikula
2021-06-24  8:51         ` Jani Nikula
2021-06-24  8:51         ` [Nouveau] " Jani Nikula
2021-06-24  9:07         ` Thomas Zimmermann
2021-06-24  9:07           ` Thomas Zimmermann
2021-06-24  9:07           ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  9:07           ` Thomas Zimmermann
2021-06-24  9:07           ` Thomas Zimmermann
2021-06-24  9:07           ` [Nouveau] " Thomas Zimmermann
2021-06-24 10:27           ` Liviu Dudau
2021-06-24 10:27             ` Liviu Dudau
2021-06-24 10:27             ` [Intel-gfx] " Liviu Dudau
2021-06-24 10:27             ` Liviu Dudau
2021-06-24 10:27             ` Liviu Dudau
2021-06-24 10:27             ` [Nouveau] " Liviu Dudau
2021-06-24 12:03           ` Thierry Reding
2021-06-24 12:03             ` Thierry Reding
2021-06-24 12:03             ` [Intel-gfx] " Thierry Reding
2021-06-24 12:03             ` Thierry Reding
2021-06-24 12:03             ` Thierry Reding
2021-06-24 12:03             ` [Nouveau] " Thierry Reding
2021-06-24 12:36             ` Jani Nikula
2021-06-24 12:36               ` Jani Nikula
2021-06-24 12:36               ` [Intel-gfx] " Jani Nikula
2021-06-24 12:36               ` Jani Nikula
2021-06-24 12:36               ` Jani Nikula
2021-06-24 12:36               ` [Nouveau] " Jani Nikula
2021-06-24 12:57               ` Thomas Zimmermann [this message]
2021-06-24 12:57                 ` Thomas Zimmermann
2021-06-24 12:57                 ` [Intel-gfx] " Thomas Zimmermann
2021-06-24 12:57                 ` Thomas Zimmermann
2021-06-24 12:57                 ` Thomas Zimmermann
2021-06-24 12:57                 ` Thomas Zimmermann
2021-06-24 12:57                 ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 05/27] drm/armada: Don't set struct drm_device.irq_enabled Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 06/27] drm/i915: Track IRQ state in local device state Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  8:08   ` Jani Nikula
2021-06-24  8:08     ` Jani Nikula
2021-06-24  8:08     ` [Intel-gfx] " Jani Nikula
2021-06-24  8:08     ` Jani Nikula
2021-06-24  8:08     ` Jani Nikula
2021-06-24  8:08     ` [Nouveau] " Jani Nikula
2021-06-24  7:28 ` [PATCH v3 07/27] drm/komeda: Don't set struct drm_device.irq_enabled Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 08/27] drm/malidp: " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 09/27] drm/exynos: " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:28 ` [PATCH v3 10/27] drm/kirin: " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` Thomas Zimmermann
2021-06-24  7:28   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 11/27] drm/imx: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  8:25   ` Philipp Zabel
2021-06-24  8:25     ` Philipp Zabel
2021-06-24  8:25     ` [Intel-gfx] " Philipp Zabel
2021-06-24  8:25     ` Philipp Zabel
2021-06-24  8:25     ` Philipp Zabel
2021-06-24  8:25     ` [Nouveau] " Philipp Zabel
2021-06-24  8:25     ` Philipp Zabel
2021-06-24  7:29 ` [PATCH v3 12/27] drm/imx/dcss: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 13/27] drm/mediatek: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 14/27] drm/nouveau: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 15/27] drm/omapdrm: Track IRQ state in local device state Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 16/27] drm/rcar-du: Don't set struct drm_device.irq_enabled Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24 10:47   ` Laurent Pinchart
2021-06-24 10:47     ` Laurent Pinchart
2021-06-24 10:47     ` [Intel-gfx] " Laurent Pinchart
2021-06-24 10:47     ` Laurent Pinchart
2021-06-24 10:47     ` Laurent Pinchart
2021-06-24 10:47     ` Laurent Pinchart
2021-06-24 10:47     ` [Nouveau] " Laurent Pinchart
2021-06-24  7:29 ` [PATCH v3 17/27] drm/rockchip: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 18/27] drm/sti: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 19/27] drm/stm: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 20/27] drm/sun4i: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 21/27] drm/tegra: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24 12:04   ` Thierry Reding
2021-06-24 12:04     ` Thierry Reding
2021-06-24 12:04     ` [Intel-gfx] " Thierry Reding
2021-06-24 12:04     ` Thierry Reding
2021-06-24 12:04     ` Thierry Reding
2021-06-24 12:04     ` [Nouveau] " Thierry Reding
2021-06-24  7:29 ` [PATCH v3 22/27] drm/tidss: Don't use " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 23/27] drm/vc4: Don't set " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 24/27] drm/vkms: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24 10:48   ` Laurent Pinchart
2021-06-24 10:48     ` Laurent Pinchart
2021-06-24 10:48     ` [Intel-gfx] " Laurent Pinchart
2021-06-24 10:48     ` Laurent Pinchart
2021-06-24 10:48     ` Laurent Pinchart
2021-06-24 10:48     ` Laurent Pinchart
2021-06-24 10:48     ` [Nouveau] " Laurent Pinchart
2021-06-24  7:29 ` [PATCH v3 25/27] drm/vmwgfx: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 26/27] drm/xlnx: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:29 ` [PATCH v3 27/27] drm/zte: " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Intel-gfx] " Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` Thomas Zimmermann
2021-06-24  7:29   ` [Nouveau] " Thomas Zimmermann
2021-06-24  7:51 ` [Intel-gfx] ✗ Fi.CI.CHECKPATCH: warning for Deprecate " Patchwork
2021-06-24  7:52 ` [Intel-gfx] ✗ Fi.CI.SPARSE: " Patchwork
2021-06-24  8:21 ` [Intel-gfx] ✓ Fi.CI.BAT: success " Patchwork
2021-06-24  9:36 ` [Intel-gfx] ✗ Fi.CI.IGT: failure " Patchwork

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=0b0b7cda-9808-f0ed-4122-2d8eeaa8f7c3@suse.de \
    --to=tzimmermann@suse.de \
    --cc=Xinhui.Pan@amd.com \
    --cc=airlied@linux.ie \
    --cc=alexander.deucher@amd.com \
    --cc=alexandre.torgue@foss.st.com \
    --cc=amd-gfx@lists.freedesktop.org \
    --cc=benjamin.gaignard@linaro.org \
    --cc=bskeggs@redhat.com \
    --cc=christian.koenig@amd.com \
    --cc=chunkuang.hu@kernel.org \
    --cc=daniel.vetter@ffwll.ch \
    --cc=dri-devel@lists.freedesktop.org \
    --cc=emma@anholt.net \
    --cc=hamohammed.sa@gmail.com \
    --cc=hjc@rock-chips.com \
    --cc=hyun.kwon@xilinx.com \
    --cc=intel-gfx@lists.freedesktop.org \
    --cc=james.qian.wang@arm.com \
    --cc=jani.nikula@linux.intel.com \
    --cc=jernej.skrabec@gmail.com \
    --cc=jonathanh@nvidia.com \
    --cc=jy0922.shim@samsung.com \
    --cc=jyri.sarha@iki.fi \
    --cc=kernel@pengutronix.de \
    --cc=kieran.bingham+renesas@ideasonboard.com \
    --cc=kong.kongxinwei@hisilicon.com \
    --cc=krzysztof.kozlowski@canonical.com \
    --cc=kyungmin.park@samsung.com \
    --cc=laurent.pinchart@ideasonboard.com \
    --cc=laurentiu.palcu@oss.nxp.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-graphics-maintainer@vmware.com \
    --cc=linux-imx@nxp.com \
    --cc=linux-mediatek@lists.infradead.org \
    --cc=linux-rockchip@lists.infradead.org \
    --cc=linux-samsung-soc@vger.kernel.org \
    --cc=linux-stm32@st-md-mailman.stormreply.com \
    --cc=linux-sunxi@lists.linux.dev \
    --cc=linux-tegra@vger.kernel.org \
    --cc=linux@armlinux.org.uk \
    --cc=liviu.dudau@arm.com \
    --cc=matthias.bgg@gmail.com \
    --cc=mcoquelin.stm32@gmail.com \
    --cc=melissa.srw@gmail.com \
    --cc=michal.simek@xilinx.com \
    --cc=mihail.atanassov@arm.com \
    --cc=nouveau@lists.freedesktop.org \
    --cc=philippe.cornu@foss.st.com \
    --cc=puck.chen@hisilicon.com \
    --cc=rodrigo.vivi@intel.com \
    --cc=rodrigosiqueiramelo@gmail.com \
    --cc=s.hauer@pengutronix.de \
    --cc=shawnguo@kernel.org \
    --cc=sw0312.kim@samsung.com \
    --cc=thierry.reding@gmail.com \
    --cc=tiantao6@hisilicon.com \
    --cc=tomba@kernel.org \
    --cc=wens@csie.org \
    --cc=xinliang.liu@linaro.org \
    --cc=yannick.fertre@foss.st.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.