[libcamera-devel] [PATCH v4 21/22] libcamera: base: shared_fd: Rename fd() to get()

Jacopo Mondi jacopo at jmondi.org
Tue Nov 30 09:10:00 CET 2021


Hi Laurent

On Tue, Nov 30, 2021 at 05:38:19AM +0200, Laurent Pinchart wrote:
> For consistency with UniqueFD, rename the fd() function to get().
> Renaming UniqueFD::get() to fd() would have been another option, but was
> rejected to keep as close as possible to the std::shared_ptr<> and
> std::unique_ptr<> APIs.
>
> Signed-off-by: Laurent Pinchart <laurent.pinchart at ideasonboard.com>

I like this!

Reviewed-by: Jacopo Mondi <jacopo at jmondi.org>
Thanks
  j

> ---
>  include/libcamera/base/shared_fd.h            |  2 +-
>  include/libcamera/internal/v4l2_videodevice.h |  2 +-
>  src/cam/drm.cpp                               |  4 +-
>  src/cam/image.cpp                             |  4 +-
>  src/gstreamer/gstlibcameraallocator.cpp       |  2 +-
>  src/ipa/raspberrypi/raspberrypi.cpp           |  2 +-
>  src/libcamera/base/shared_fd.cpp              |  4 +-
>  src/libcamera/framebuffer.cpp                 |  2 +-
>  src/libcamera/ipc_pipe.cpp                    |  2 +-
>  src/libcamera/mapped_framebuffer.cpp          |  4 +-
>  .../pipeline/raspberrypi/raspberrypi.cpp      |  2 +-
>  src/libcamera/v4l2_videodevice.cpp            |  6 +--
>  src/v4l2/v4l2_camera.cpp                      |  2 +-
>  test/shared-fd.cpp                            | 39 ++++++++++---------
>  14 files changed, 39 insertions(+), 38 deletions(-)
>
> diff --git a/include/libcamera/base/shared_fd.h b/include/libcamera/base/shared_fd.h
> index 1dd51a7f046b..e53a8b88601e 100644
> --- a/include/libcamera/base/shared_fd.h
> +++ b/include/libcamera/base/shared_fd.h
> @@ -27,7 +27,7 @@ public:
>  	SharedFD &operator=(SharedFD &&other);
>
>  	bool isValid() const { return fd_ != nullptr; }
> -	int fd() const { return fd_ ? fd_->fd() : -1; }
> +	int get() const { return fd_ ? fd_->fd() : -1; }
>  	UniqueFD dup() const;
>
>  private:
> diff --git a/include/libcamera/internal/v4l2_videodevice.h b/include/libcamera/internal/v4l2_videodevice.h
> index 5ba2b54643ac..9b2ec3afecff 100644
> --- a/include/libcamera/internal/v4l2_videodevice.h
> +++ b/include/libcamera/internal/v4l2_videodevice.h
> @@ -140,7 +140,7 @@ private:
>  	private:
>  		struct Plane {
>  			Plane(const FrameBuffer::Plane &plane)
> -				: fd(plane.fd.fd()), length(plane.length)
> +				: fd(plane.fd.get()), length(plane.length)
>  			{
>  			}
>
> diff --git a/src/cam/drm.cpp b/src/cam/drm.cpp
> index f25300913a7f..46e34eb546fb 100644
> --- a/src/cam/drm.cpp
> +++ b/src/cam/drm.cpp
> @@ -608,12 +608,12 @@ std::unique_ptr<FrameBuffer> Device::createFrameBuffer(
>
>  	unsigned int i = 0;
>  	for (const libcamera::FrameBuffer::Plane &plane : planes) {
> -		int fd = plane.fd.fd();
> +		int fd = plane.fd.get();
>  		uint32_t handle;
>
>  		auto iter = fb->planes_.find(fd);
>  		if (iter == fb->planes_.end()) {
> -			ret = drmPrimeFDToHandle(fd_, plane.fd.fd(), &handle);
> +			ret = drmPrimeFDToHandle(fd_, plane.fd.get(), &handle);
>  			if (ret < 0) {
>  				ret = -errno;
>  				std::cerr
> diff --git a/src/cam/image.cpp b/src/cam/image.cpp
> index 0180be78d396..fe2cc6da5a15 100644
> --- a/src/cam/image.cpp
> +++ b/src/cam/image.cpp
> @@ -39,7 +39,7 @@ std::unique_ptr<Image> Image::fromFrameBuffer(const FrameBuffer *buffer, MapMode
>  	std::map<int, MappedBufferInfo> mappedBuffers;
>
>  	for (const FrameBuffer::Plane &plane : buffer->planes()) {
> -		const int fd = plane.fd.fd();
> +		const int fd = plane.fd.get();
>  		if (mappedBuffers.find(fd) == mappedBuffers.end()) {
>  			const size_t length = lseek(fd, 0, SEEK_END);
>  			mappedBuffers[fd] = MappedBufferInfo{ nullptr, 0, length };
> @@ -61,7 +61,7 @@ std::unique_ptr<Image> Image::fromFrameBuffer(const FrameBuffer *buffer, MapMode
>  	}
>
>  	for (const FrameBuffer::Plane &plane : buffer->planes()) {
> -		const int fd = plane.fd.fd();
> +		const int fd = plane.fd.get();
>  		auto &info = mappedBuffers[fd];
>  		if (!info.address) {
>  			void *address = mmap(nullptr, info.mapLength, mmapFlags,
> diff --git a/src/gstreamer/gstlibcameraallocator.cpp b/src/gstreamer/gstlibcameraallocator.cpp
> index cb07d6e9e87f..c740b8fc82a8 100644
> --- a/src/gstreamer/gstlibcameraallocator.cpp
> +++ b/src/gstreamer/gstlibcameraallocator.cpp
> @@ -52,7 +52,7 @@ FrameWrap::FrameWrap(GstAllocator *allocator, FrameBuffer *buffer,
>  	  outstandingPlanes_(0)
>  {
>  	for (const FrameBuffer::Plane &plane : buffer->planes()) {
> -		GstMemory *mem = gst_fd_allocator_alloc(allocator, plane.fd.fd(),
> +		GstMemory *mem = gst_fd_allocator_alloc(allocator, plane.fd.get(),
>  							plane.offset + plane.length,
>  							GST_FD_MEMORY_FLAG_DONT_CLOSE);
>  		gst_memory_resize(mem, plane.offset, plane.length);
> diff --git a/src/ipa/raspberrypi/raspberrypi.cpp b/src/ipa/raspberrypi/raspberrypi.cpp
> index aaf629eeb3fc..0ed41385018a 100644
> --- a/src/ipa/raspberrypi/raspberrypi.cpp
> +++ b/src/ipa/raspberrypi/raspberrypi.cpp
> @@ -377,7 +377,7 @@ int IPARPi::configure(const IPACameraSensorInfo &sensorInfo,
>  		lsTableHandle_ = std::move(ipaConfig.lsTableHandle);
>  		if (lsTableHandle_.isValid()) {
>  			lsTable_ = mmap(nullptr, ipa::RPi::MaxLsGridSize, PROT_READ | PROT_WRITE,
> -					MAP_SHARED, lsTableHandle_.fd(), 0);
> +					MAP_SHARED, lsTableHandle_.get(), 0);
>
>  			if (lsTable_ == MAP_FAILED) {
>  				LOG(IPARPI, Error) << "dmaHeap mmap failure for LS table.";
> diff --git a/src/libcamera/base/shared_fd.cpp b/src/libcamera/base/shared_fd.cpp
> index 56dc579258c7..0c8b93a47f85 100644
> --- a/src/libcamera/base/shared_fd.cpp
> +++ b/src/libcamera/base/shared_fd.cpp
> @@ -208,7 +208,7 @@ SharedFD &SharedFD::operator=(SharedFD &&other)
>   */
>
>  /**
> - * \fn SharedFD::fd()
> + * \fn SharedFD::get()
>   * \brief Retrieve the numerical file descriptor
>   * \return The numerical file descriptor, which may be -1 if the SharedFD
>   * instance is invalid
> @@ -253,7 +253,7 @@ SharedFD &SharedFD::operator=(SharedFD &&other)
>   */
>  UniqueFD SharedFD::dup() const
>  {
> -	int dupFd = ::dup(fd());
> +	int dupFd = ::dup(get());
>  	if (dupFd == -1) {
>  		int ret = -errno;
>  		LOG(SharedFD, Error)
> diff --git a/src/libcamera/framebuffer.cpp b/src/libcamera/framebuffer.cpp
> index f313566c5561..701212f3ae21 100644
> --- a/src/libcamera/framebuffer.cpp
> +++ b/src/libcamera/framebuffer.cpp
> @@ -218,7 +218,7 @@ ino_t fileDescriptorInode(const SharedFD &fd)
>  		return 0;
>
>  	struct stat st;
> -	int ret = fstat(fd.fd(), &st);
> +	int ret = fstat(fd.get(), &st);
>  	if (ret < 0) {
>  		ret = -errno;
>  		LOG(Buffer, Fatal)
> diff --git a/src/libcamera/ipc_pipe.cpp b/src/libcamera/ipc_pipe.cpp
> index 3b47032de0a2..31a0ca09f9f0 100644
> --- a/src/libcamera/ipc_pipe.cpp
> +++ b/src/libcamera/ipc_pipe.cpp
> @@ -113,7 +113,7 @@ IPCUnixSocket::Payload IPCMessage::payload() const
>  	}
>
>  	for (const SharedFD &fd : fds_)
> -		payload.fds.push_back(fd.fd());
> +		payload.fds.push_back(fd.get());
>
>  	return payload;
>  }
> diff --git a/src/libcamera/mapped_framebuffer.cpp b/src/libcamera/mapped_framebuffer.cpp
> index 464d35fef2d2..6860069b68ca 100644
> --- a/src/libcamera/mapped_framebuffer.cpp
> +++ b/src/libcamera/mapped_framebuffer.cpp
> @@ -198,7 +198,7 @@ MappedFrameBuffer::MappedFrameBuffer(const FrameBuffer *buffer, MapFlags flags)
>  	std::map<int, MappedBufferInfo> mappedBuffers;
>
>  	for (const FrameBuffer::Plane &plane : buffer->planes()) {
> -		const int fd = plane.fd.fd();
> +		const int fd = plane.fd.get();
>  		if (mappedBuffers.find(fd) == mappedBuffers.end()) {
>  			const size_t length = lseek(fd, 0, SEEK_END);
>  			mappedBuffers[fd] = MappedBufferInfo{ nullptr, 0, length };
> @@ -220,7 +220,7 @@ MappedFrameBuffer::MappedFrameBuffer(const FrameBuffer *buffer, MapFlags flags)
>  	}
>
>  	for (const FrameBuffer::Plane &plane : buffer->planes()) {
> -		const int fd = plane.fd.fd();
> +		const int fd = plane.fd.get();
>  		auto &info = mappedBuffers[fd];
>  		if (!info.address) {
>  			void *address = mmap(nullptr, info.mapLength, mmapFlags,
> diff --git a/src/libcamera/pipeline/raspberrypi/raspberrypi.cpp b/src/libcamera/pipeline/raspberrypi/raspberrypi.cpp
> index fdcd1eca11d6..fa2848533b29 100644
> --- a/src/libcamera/pipeline/raspberrypi/raspberrypi.cpp
> +++ b/src/libcamera/pipeline/raspberrypi/raspberrypi.cpp
> @@ -1470,7 +1470,7 @@ void RPiCameraData::setIspControls(const ControlList &controls)
>  		Span<uint8_t> s = value.data();
>  		bcm2835_isp_lens_shading *ls =
>  			reinterpret_cast<bcm2835_isp_lens_shading *>(s.data());
> -		ls->dmabuf = lsTable_.fd();
> +		ls->dmabuf = lsTable_.get();
>  	}
>
>  	isp_[Isp::Input].dev()->setControls(&ctrls);
> diff --git a/src/libcamera/v4l2_videodevice.cpp b/src/libcamera/v4l2_videodevice.cpp
> index 0d214d9edc7a..b4b89e2759b9 100644
> --- a/src/libcamera/v4l2_videodevice.cpp
> +++ b/src/libcamera/v4l2_videodevice.cpp
> @@ -282,7 +282,7 @@ bool V4L2BufferCache::Entry::operator==(const FrameBuffer &buffer) const
>  		return false;
>
>  	for (unsigned int i = 0; i < planes.size(); i++)
> -		if (planes_[i].fd != planes[i].fd.fd() ||
> +		if (planes_[i].fd != planes[i].fd.get() ||
>  		    planes_[i].length != planes[i].length)
>  			return false;
>  	return true;
> @@ -1517,9 +1517,9 @@ int V4L2VideoDevice::queueBuffer(FrameBuffer *buffer)
>  	if (buf.memory == V4L2_MEMORY_DMABUF) {
>  		if (multiPlanar) {
>  			for (unsigned int p = 0; p < numV4l2Planes; ++p)
> -				v4l2Planes[p].m.fd = planes[p].fd.fd();
> +				v4l2Planes[p].m.fd = planes[p].fd.get();
>  		} else {
> -			buf.m.fd = planes[0].fd.fd();
> +			buf.m.fd = planes[0].fd.get();
>  		}
>  	}
>
> diff --git a/src/v4l2/v4l2_camera.cpp b/src/v4l2/v4l2_camera.cpp
> index 464507505c79..e922b9e6aab2 100644
> --- a/src/v4l2/v4l2_camera.cpp
> +++ b/src/v4l2/v4l2_camera.cpp
> @@ -195,7 +195,7 @@ int V4L2Camera::getBufferFd(unsigned int index)
>  	if (buffers.size() <= index)
>  		return -1;
>
> -	return buffers[index]->planes()[0].fd.fd();
> +	return buffers[index]->planes()[0].fd.get();
>  }
>
>  int V4L2Camera::streamOn()
> diff --git a/test/shared-fd.cpp b/test/shared-fd.cpp
> index 60e5d0aaa395..997d7be18c47 100644
> --- a/test/shared-fd.cpp
> +++ b/test/shared-fd.cpp
> @@ -46,7 +46,7 @@ protected:
>  		/* Test creating empty SharedFD. */
>  		desc1_ = new SharedFD();
>
> -		if (desc1_->fd() != -1) {
> +		if (desc1_->get() != -1) {
>  			std::cout << "Failed fd numerical check (default constructor)"
>  				  << std::endl;
>  			return TestFail;
> @@ -60,19 +60,19 @@ protected:
>  		 * descriptor.
>  		 */
>  		desc1_ = new SharedFD(fd_);
> -		if (desc1_->fd() == fd_) {
> +		if (desc1_->get() == fd_) {
>  			std::cout << "Failed fd numerical check (lvalue ref constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (!isValidFd(fd_) || !isValidFd(desc1_->fd())) {
> +		if (!isValidFd(fd_) || !isValidFd(desc1_->get())) {
>  			std::cout << "Failed fd validity after construction (lvalue ref constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		int fd = desc1_->fd();
> +		int fd = desc1_->get();
>
>  		delete desc1_;
>  		desc1_ = nullptr;
> @@ -91,19 +91,19 @@ protected:
>  		int dupFdCopy = dupFd;
>
>  		desc1_ = new SharedFD(std::move(dupFd));
> -		if (desc1_->fd() != dupFdCopy) {
> +		if (desc1_->get() != dupFdCopy) {
>  			std::cout << "Failed fd numerical check (rvalue ref constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (dupFd != -1 || !isValidFd(fd_) || !isValidFd(desc1_->fd())) {
> +		if (dupFd != -1 || !isValidFd(fd_) || !isValidFd(desc1_->get())) {
>  			std::cout << "Failed fd validity after construction (rvalue ref constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		fd = desc1_->fd();
> +		fd = desc1_->get();
>
>  		delete desc1_;
>  		desc1_ = nullptr;
> @@ -118,13 +118,14 @@ protected:
>  		desc1_ = new SharedFD(fd_);
>  		desc2_ = new SharedFD(*desc1_);
>
> -		if (desc1_->fd() == fd_ || desc2_->fd() == fd_ || desc1_->fd() != desc2_->fd()) {
> +		if (desc1_->get() == fd_ || desc2_->get() == fd_ ||
> +		    desc1_->get() != desc2_->get()) {
>  			std::cout << "Failed fd numerical check (copy constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (!isValidFd(desc1_->fd()) || !isValidFd(desc2_->fd())) {
> +		if (!isValidFd(desc1_->get()) || !isValidFd(desc2_->get())) {
>  			std::cout << "Failed fd validity after construction (copy constructor)"
>  				  << std::endl;
>  			return TestFail;
> @@ -133,7 +134,7 @@ protected:
>  		delete desc1_;
>  		desc1_ = nullptr;
>
> -		if (!isValidFd(desc2_->fd())) {
> +		if (!isValidFd(desc2_->get())) {
>  			std::cout << "Failed fd validity after destruction (copy constructor)"
>  				  << std::endl;
>  			return TestFail;
> @@ -144,16 +145,16 @@ protected:
>
>  		/* Test creating SharedFD by taking over other SharedFD. */
>  		desc1_ = new SharedFD(fd_);
> -		fd = desc1_->fd();
> +		fd = desc1_->get();
>  		desc2_ = new SharedFD(std::move(*desc1_));
>
> -		if (desc1_->fd() != -1 || desc2_->fd() != fd) {
> +		if (desc1_->get() != -1 || desc2_->get() != fd) {
>  			std::cout << "Failed fd numerical check (move constructor)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (!isValidFd(desc2_->fd())) {
> +		if (!isValidFd(desc2_->get())) {
>  			std::cout << "Failed fd validity after construction (move constructor)"
>  				  << std::endl;
>  			return TestFail;
> @@ -168,16 +169,16 @@ protected:
>  		desc1_ = new SharedFD();
>  		desc2_ = new SharedFD(fd_);
>
> -		fd = desc2_->fd();
> +		fd = desc2_->get();
>  		*desc1_ = *desc2_;
>
> -		if (desc1_->fd() != fd || desc2_->fd() != fd) {
> +		if (desc1_->get() != fd || desc2_->get() != fd) {
>  			std::cout << "Failed fd numerical check (copy assignment)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (!isValidFd(desc1_->fd()) || !isValidFd(desc2_->fd())) {
> +		if (!isValidFd(desc1_->get()) || !isValidFd(desc2_->get())) {
>  			std::cout << "Failed fd validity after construction (copy assignment)"
>  				  << std::endl;
>  			return TestFail;
> @@ -192,16 +193,16 @@ protected:
>  		desc1_ = new SharedFD();
>  		desc2_ = new SharedFD(fd_);
>
> -		fd = desc2_->fd();
> +		fd = desc2_->get();
>  		*desc1_ = std::move(*desc2_);
>
> -		if (desc1_->fd() != fd || desc2_->fd() != -1) {
> +		if (desc1_->get() != fd || desc2_->get() != -1) {
>  			std::cout << "Failed fd numerical check (move assignment)"
>  				  << std::endl;
>  			return TestFail;
>  		}
>
> -		if (!isValidFd(desc1_->fd())) {
> +		if (!isValidFd(desc1_->get())) {
>  			std::cout << "Failed fd validity after construction (move assignment)"
>  				  << std::endl;
>  			return TestFail;
> --
> Regards,
>
> Laurent Pinchart
>


More information about the libcamera-devel mailing list