On Mon, Jan 23, 2023 at 06:15:00PM +0500, Muhammad Usama Anjum wrote: > > Firstly, doc update is more than welcomed to explain the new interface > > first (before throwing the code..). That can be done in pagemap.rst on > > pagemap changes, or userfaultfd.rst on userfaultfd. > Okay. I'll add the documentation in next version or after the series has > been accepted. Initially I'd added the documentation. But the code kept on > changing so much that I had to spend considerable time on updating the > documentation. I know it is better to add documentation with the patches. > I'll try to add it. Yes, logically it should be the thing people start looking with. It'll help reviewers to understand how does it work in general if relevant description is not in the cover letter, so it can matter even before the series is merged. > > There're four kinds of masks (required/anyof/excluded/return). Are they > > all needed? Why this is a good interface design? > Then, CRIU developers Andrea [1] and Danylo [2], asked to include all these > different kinds of masks. I'd thought of these masks as fancy filter inside > the kernel. But there wasn't anyone else to review. So I'd included them to > move forward. Please let me know your thoughts after reading emails from [1]. The idea makes sense to me, thanks. I just hope "moving it forward" is not the only reason that you included it. Please also consider to attach relevant links to your next cover letter so new reviewers can be aware of why the interface is proposed like that. IMHO it would be also great if the CRIU people can acknowledge the interface at some point to make sure it satisfies the needs. An POC would be even better on CRIU, but maybe that's asking too much. -- Peter Xu
