Page MenuHomeFreeBSD

bhyve: support noVNC SetPixelFormat request
ClosedPublic

Authored by mp on Aug 21 2024, 6:56 PM.
Tags
None
Referenced Files
Unknown Object (File)
Sat, Nov 30, 4:00 PM
Unknown Object (File)
Nov 22 2024, 10:01 PM
Unknown Object (File)
Nov 18 2024, 8:46 AM
Unknown Object (File)
Nov 15 2024, 9:50 AM
Unknown Object (File)
Nov 15 2024, 9:17 AM
Unknown Object (File)
Nov 15 2024, 9:02 AM
Unknown Object (File)
Nov 15 2024, 8:48 AM
Unknown Object (File)
Nov 15 2024, 8:47 AM

Details

Summary

The bhyve VNC server would ignore the SetPixelFormat message from the
VNC client. This change supports a limited implementation to detect
and reorder the colors such as requested from the noVNC client.

PR: 280984

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 59129
Build 56016: arc lint + arc unit

Event Timeline

mp requested review of this revision.Aug 21 2024, 6:56 PM
corvink added inline comments.
usr.sbin/bhyve/rfb.c
343

Should we emit warning here? So if the client requests a different bit depth, the user gets a warning about it and won't get confused by the wrong VNC output?

355–358

Shouldn't we compare those values to our current settings e.g. rc->red_shift etc.? What happens if client changes the pixel format twice?

367–377

Just a suggestion to reduce indentation.

457

It's very inefficient to convert the pixel format everytime. Not sure if it's a noticeable performance issue. Is it too complicated to change the server format?

458–460

Why don't you use your shift defines here?

575

Addressing review feedback from corvink

mp marked an inline comment as done.Aug 23 2024, 1:54 AM

Thank you for the review feedback. I think I address most of it.

usr.sbin/bhyve/rfb.c
343

I don't think this is necessary. We were ignoring it completely with the prior implementation and always forcing our server format. While there is flexibility in the protocol, really the majority of clients just have the normal RGB output (except noVNC that has BGR).

355–358

I reworked the code to pick up new shift values. But once we start transposing the colors, we will continue regardless. I didn't want to complicate free-ing the pixel buffer since it would need to coordinate with the writing thread. Really not worth the hassle.

367–377

I incorporated this into the code path with other changes. Thanks.

457

Understood. I'm not sure it is easy to change the server format. And this is only done when there is a non-server format request made. Otherwise it just sends out the gc buffer. I may look for a future improvement to use AVX to reduce this overhead.

458–460

Thank you, good point. I originally used the same form as the original code and then switched to defining the SHIFT's. I forgot about this one so it has been updated.

usr.sbin/bhyve/rfb.c
343

Well, you were confused about the prior implementation because it didn't warn you that it has ignored the SetPixelFormat command. So, it might be a good idea to improve that in your updated version and warn user when we're ignoring the command.

346–348

Sry, if I misunderstand this. I'm unfamiliar with the VNC code. pixfmt_msg was read from the client right? So, should we use nstoh here?

355–358

How is this intended to work? Imagine a client requests BGR. Then we're changing all rc->shift values. After some time, the client requests RGB for some reason. We would exit here without changing the rc->shift values. So, we're continuing sending in BGR format, wouldn't we? So, this check should be moved down after changing rc values.

453

If a client switches from BGR back to RGB, we could avoid rewriting the pixels by checking if the shift values match the server format here.

461–463

Is this function called in the same thread as the set_pixfmt function? If not, we require some kind of locking to read/write these shift values. I'm unfamiliar with the VNC code and don't know if it already holds a lock or not.

1318

That's unrelated and can get it's own commit.

Addressing further review feedback

From the VNC clients I have looked at, SetPixelFormat is usually set
at the beginning of the session and not reverted. However, handling
switching between VNC clients with different formats did need further
adjustments. Using a pthread mutex in the main data path (the write
thread) would have an adverse effect on performance. The approach I
took was to use an atomic_bool to notify the write thread of new values
and new value struct that is protected by a pthread mutex.

I also added warnings suggested in the review when invalid values are
sent via SetPixelFormat. Note: one of the VNC clients I tested with
will initially send a bpp value (8) which emits a warning now and
the client sends a subsequent valid bpp value (32). Hopefully users
are not confused by this warning.

mp marked 4 inline comments as done.Aug 24 2024, 8:03 PM
mp added inline comments.
usr.sbin/bhyve/rfb.c
355–358

Reworked. See comment associated with new update.

453

If our server format is requested again, the new version will NULL out pixrow so the adjustment won't happen.

461–463

Reworked. See comment associated with new update.

usr.sbin/bhyve/rfb.c
343

Nit: The pixfmt is unsupported not invalid, isn't it?

354

Same here. Are those max values invalid or unsupported?

372–374

It may make sense to update these values with pixfmt_mtx held. When SetPixelFormat is called twice very fast (I know it's just a theoretical scenario), we would end up with the same race as before. A proper solution might be:

	if (red_shift == PIXEL_RED_SHIFT &&
	    green_shift == PIXEL_GREEN_SHIFT &&
	    blue_shift == PIXEL_BLUE_SHIFT) {
		pixelp = NULL;
	} else {
		/* write thread adjusts a row at a time */
		pixelp = malloc(RFB_MAX_WIDTH * sizeof(uint32_t));
		if (pixelp == NULL) {
			WPRINTF(("rfb: could not allocate pixel array"));
			return;
		}
	}

	pthread_mutex_lock(&rc->pixfmt_mtx);
	rc->new_pixfmt.red_shift = red_shift;
	rc->new_pixfmt.green_shift = green_shift;
	rc->new_pixfmt.blue_shift = blue_shift;
	if (rc->new_pixfmt.pixrow)
		free(rc->new_pixfmt.pixrow);
	rc->new_pixfmt.pixrow = pixelp;
	pthread_mutex_unlock(&rc->pixfmt_mtx);

	rc->update_pixfmt = true;
384

Theoretically, when updating the pixfmt very fast, we could end up allocating the pixrow buffer twice without freeing the first one.

It might be a better idea to let the write thread set pixrow to NULL when it picks it up. So, here we can free any non NULL value (see suggestion above).

663

Is this function called by multiple threads? Otherwise, this mtx is useless in your current approach.

1311
mp marked 2 inline comments as done.

Address review feedback

  • Changed warning from "invalid" to "unsupported"
  • Double checked mutex handling
  • Moved malloc/free to write thread
  • Note: we could consider not free'ing the buffer once allocated as it is only ~8k as we already keep it around between sessions.
mp marked 5 inline comments as done.Aug 28 2024, 1:01 AM
mp added inline comments.
usr.sbin/bhyve/rfb.c
384

Moved both malloc/free to the write thread.

usr.sbin/bhyve/rfb.c
640–650

I'm fine with allocating the buffer once. If you like to change it, just allocate the buffer on init to make it even simpler.

1311

You have to address this.

mp marked an inline comment as done.

Address review feedback

  • Remove pixmap malloc/free from write thread and malloc once at initialization similar to the zbuf malloc.
  • In error handling, add pthread_mutex_destroy.
mp marked 7 inline comments as done.Aug 28 2024, 3:29 PM

@corvink thank you for the reviews. Hopefully these last changes should address all of your feedback.

usr.sbin/bhyve/rfb.c
1318

While I understand changes should be related to the issue being fixed, I think this one is fine to include since a similar line is being added next to it.

In D46402#1059143, @mp wrote:

@corvink thank you for the reviews. Hopefully these last changes should address all of your feedback.

Thanks for your contribution! I'm going to test this before merging.

usr.sbin/bhyve/rfb.c
1123

I see that you copied this from the zbuf. However, that's not correct. Commonly assertions are removed in release build. We don't want to continue on a failed allocation in release builds! I know that bhyve enables assertions even in release builds but that's a bug and we should ideally change that behavior in the future. Therefore, we should avoid making this migration harder by making our code even more depend on assertions.

1318

From my experience, FreeBSD isn't strict on that, so I'm fine with it.

Personally, I try to avoid such changes because they can be confusing and blow up your commit, making it harder to review and to analyze when hunting bugs. Just image what happens if zbuf isn't initialized to NULL causing free to be called on a random value under some conditions. After noticing that something is wrong and performing a git bisect, you end up with this commit. It may take some time until you notice that this commit not just adds supports for different PixelFmts. It's also fixing a different bug but you have to find that single line in your bigger overall change.

This revision is now accepted and ready to land.Aug 29 2024, 8:34 AM
mp marked an inline comment as done.

Address review feedback

  • Moved pixrow initialization and removed associated assert
  • Removed extraneous free (will address later when removing another assert)
This revision now requires review to proceed.Aug 29 2024, 4:44 PM
mp marked 2 inline comments as done.Aug 29 2024, 4:53 PM

@corvink your last comment included "I'm going to test this before merging.". I'm assuming you meant "before accepting" and then I will merge onto main and push the commit.

usr.sbin/bhyve/rfb.c
1123

Moved allocation to initialization and removed the assert.

1318

Removed.

This revision is now accepted and ready to land.Sep 9 2024, 9:38 AM
This revision was automatically updated to reflect the committed changes.
mp marked 2 inline comments as done.