Bug 1573281

Summary: mlock.2: Document new mlock2(2) system call
Product: Red Hat Enterprise Linux 7 Reporter: Rafael Aquini <aquini>
Component: man-pages-overridesAssignee: Nikola Forró <nforro>
Status: CLOSED ERRATA QA Contact: Jan Houska <jhouska>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.6CC: djez, nforro, smoroney, vondruch
Target Milestone: rcKeywords: ManPageChange, Patch
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: man-pages-overrides-7.6.1-1.el7 Doc Type: No Doc Update
Doc Text:
undefined
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-10-30 11:34:51 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 1560030    
Bug Blocks: 1592877    

Description Rafael Aquini 2018-04-30 18:05:35 UTC
Via bug 1560030 we're backporting the new system call MLOCK2(2), and as such its availability must be documented accordingly in the man pages.

Comment 6 Jan Houska 2018-08-17 12:35:55 UTC
VERIFIED:

New PASS:
man-pages-overrides-7.6.1-3.el7

"""
# man 2 mlock2 

MLOCK(2)                                                                        Linux Programmer's Manual                                                                       MLOCK(2)

NAME
       mlock, mlock2, munlock, mlockall, munlockall - lock and unlock memory

SYNOPSIS
       #include <sys/mman.h>

       int mlock(const void *addr, size_t len);
       int mlock2(const void *addr, size_t len, int flags);
       int munlock(const void *addr, size_t len);

       int mlockall(int flags);
       int munlockall(void);

DESCRIPTION
       mlock(), mlock2(), and mlockall() lock part or all of the calling process's virtual address space into RAM, preventing that memory from being paged to the swap area.

       munlock()  and  munlockall() perform the converse operation, unlocking part or all of the calling process's virtual address space, so that pages in the specified virtual address
       range may once more to be swapped out if required by the kernel memory manager.

       Memory locking and unlocking are performed in units of whole pages.
"""


Old FAIL:
man-pages-overrides-7.5.2-1.el7

#man 2 mlock2

No output on 'man 2 mlock2'

Comment 9 errata-xmlrpc 2018-10-30 11:34:51 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:3254