job.c File Reference

#include <win32k.h>

Include dependency graph for job.c:

Go to the source code of this file.

Macros
#define	JOB_PROCESS_GROWTH   8
#define	JOB_HANDLE_GROWTH   16

Functions
	DBG_DEFAULT_CHANNEL (UserProcess)
	_Requires_lock_held_ (UserLock)
	_Requires_exclusive_lock_held_ (UserLock)
static NTSTATUS	IntJobSetRestrictions (_In_ PEJOB pEJob, _In_ ULONG UIRestrictions)
static NTSTATUS	IntJobAddProcess (_In_ PEJOB pEJob, _In_ PPROCESSINFO ppi)
static NTSTATUS	IntJobTerminate (_In_ PEJOB pEJob)
NTSTATUS NTAPI	Win32kJobCallout (_In_ PWIN32_JOBCALLOUT_PARAMETERS Parameters)
BOOL APIENTRY	NtUserUserHandleGrantAccess (_In_ HANDLE hUserHandle, _In_ HANDLE hJob, _In_ BOOL bGrant)

Variables
static PJOBINFO	gJobInfoList = NULL

Macro Definition Documentation

JOB_HANDLE_GROWTH

#define JOB_HANDLE_GROWTH   16

Definition at line 24 of file job.c.

JOB_PROCESS_GROWTH

#define JOB_PROCESS_GROWTH   8

Definition at line 23 of file job.c.

Function Documentation

_Requires_exclusive_lock_held_()

_Requires_exclusive_lock_held_

(

UserLock

)

Definition at line 50 of file job.c.

{
    PJOBINFO pJobInfo;
    NTSTATUS Status;
 
    ASSERT(UserIsEnteredExclusive());
 
    pJobInfo = ExAllocatePoolZero(PagedPool, sizeof(JOBINFO), USERTAG_W32JOB);
    if (pJobInfo == NULL)
    {
        ERR("Failed to allocate a JOBINFO for job %p\n", pEJob);
        return NULL;
    }
 
    Status = RtlCreateAtomTable(37, &pJobInfo->pAtomTable);
    if (!NT_SUCCESS(Status))
    {
        ERR("Failed to create the atom table of job %p: 0x%lx\n", pEJob, Status);
        ExFreePoolWithTag(pJobInfo, USERTAG_W32JOB);
        return NULL;
    }
 
    pJobInfo->pEJob = pEJob;
 
    pJobInfo->Next = gJobInfoList;
    gJobInfoList = pJobInfo;
 
    TRACE("Created JOBINFO %p for job %p\n", pJobInfo, pEJob);
    return pJobInfo;
}

_Requires_lock_held_()

_Requires_lock_held_

(

UserLock

)

Definition at line 32 of file job.c.

{
    PJOBINFO pJobInfo;
 
    ASSERT(UserIsEntered());
 
    for (pJobInfo = gJobInfoList; pJobInfo != NULL; pJobInfo = pJobInfo->Next)
    {
        if (pJobInfo->pEJob == pEJob)
            return pJobInfo;
    }
 
    return NULL;
}

DBG_DEFAULT_CHANNEL()

DBG_DEFAULT_CHANNEL

(

UserProcess

)

IntJobAddProcess()

static NTSTATUS IntJobAddProcess ( _In_ PEJOB  pEJob, _In_ PPROCESSINFO  ppi  )

static

Definition at line 328 of file job.c.

{
    NTSTATUS Status;
    PJOBINFO pJobInfo;
 
    UserEnterExclusive();
 
    pJobInfo = IntFindJobInfo(pEJob);
    if (pJobInfo == NULL)
    {
        /* The kernel only calls us for jobs that have restrictions,
           so we should have been told about this job already */
        ERR("No JOBINFO for job %p\n", pEJob);
        Status = STATUS_UNSUCCESSFUL;
    }
    else
    {
        Status = IntAddProcessToJobInfo(pJobInfo, ppi);
    }
 
    UserLeave();
    return Status;
}

Referenced by Win32kJobCallout().

IntJobSetRestrictions()

static NTSTATUS IntJobSetRestrictions ( _In_ PEJOB  pEJob, _In_ ULONG  UIRestrictions  )

static

Definition at line 266 of file job.c.

{
    NTSTATUS Status = STATUS_SUCCESS;
    PJOBINFO pJobInfo;
    BOOL Created = FALSE;
 
    UserEnterExclusive();
 
    pJobInfo = IntFindJobInfo(pEJob);
 
    /* No restrictions left, so no state to keep */
    if (UIRestrictions == 0)
    {
        if (pJobInfo != NULL)
            IntDestroyJobInfo(pJobInfo);
 
        goto Quit;
    }
 
    if (pJobInfo == NULL)
    {
        PPROCESSINFO ppi;
 
        pJobInfo = IntCreateJobInfo(pEJob);
        if (pJobInfo == NULL)
        {
            Status = STATUS_NO_MEMORY;
            goto Quit;
        }
 
        Created = TRUE;
 
        /* The job may already hold processes that connected to USER before
           the restrictions were applied */
        for (ppi = gppiList; ppi != NULL; ppi = ppi->ppiNext)
        {
            if (ppi->peProcess != NULL &&
                PsGetProcessJob(ppi->peProcess) == pEJob)
            {
                Status = IntAddProcessToJobInfo(pJobInfo, ppi);
                if (!NT_SUCCESS(Status))
                    goto Quit;
            }
        }
    }
 
    pJobInfo->UIRestrictions = UIRestrictions;
 
Quit:
    /* Undo a job we did not manage to finish building */
    if (!NT_SUCCESS(Status) && Created)
        IntDestroyJobInfo(pJobInfo);
 
    UserLeave();
    return Status;
}

Referenced by Win32kJobCallout().

IntJobTerminate()

static NTSTATUS IntJobTerminate ( _In_ PEJOB  pEJob )

static

Definition at line 357 of file job.c.

{
    PJOBINFO pJobInfo;
 
    UserEnterExclusive();
 
    pJobInfo = IntFindJobInfo(pEJob);
    if (pJobInfo != NULL)
        IntDestroyJobInfo(pJobInfo);
 
    UserLeave();
    return STATUS_SUCCESS;
}

Referenced by Win32kJobCallout().

NtUserUserHandleGrantAccess()

BOOL APIENTRY NtUserUserHandleGrantAccess	(	_In_ HANDLE	hUserHandle,
		_In_ HANDLE	hJob,
		_In_ BOOL	bGrant
	)

Definition at line 587 of file job.c.

{
    PEJOB pEJob;
    PJOBINFO pJobInfo;
    NTSTATUS Status;
    BOOL Ret = FALSE;
 
    if (hUserHandle == NULL)
    {
        EngSetLastError(ERROR_INVALID_PARAMETER);
        return FALSE;
    }
 
    Status = ObReferenceObjectByHandle(hJob,
                                       JOB_OBJECT_SET_ATTRIBUTES,
                                       PsJobType,
                                       UserMode,
                                       (PVOID*)&pEJob,
                                       NULL);
    if (!NT_SUCCESS(Status))
    {
        SetLastNtError(Status);
        return FALSE;
    }
 
    UserEnterExclusive();
 
    pJobInfo = IntFindJobInfo(pEJob);
    if (pJobInfo == NULL)
    {
        /* A job with no UI restrictions at all keeps no granted list */
        EngSetLastError(ERROR_INVALID_PARAMETER);
    }
    else
    {
        Ret = IntGrantHandleToJob(pJobInfo, hUserHandle, bGrant);
    }
 
    UserLeave();
 
    ObDereferenceObject(pEJob);
    return Ret;
}

Win32kJobCallout()

NTSTATUS NTAPI Win32kJobCallout

(

_In_ PWIN32_JOBCALLOUT_PARAMETERS

Parameters

)

Definition at line 476 of file job.c.

{
    switch (Parameters->CalloutType)
    {
        case PsW32JobCalloutSetInformation:
            return IntJobSetRestrictions((PEJOB)Parameters->Job,
                                         PtrToUlong(Parameters->Data));
 
        case PsW32JobCalloutAddProcess:
            return IntJobAddProcess((PEJOB)Parameters->Job,
                                    (PPROCESSINFO)Parameters->Data);
 
        case PsW32JobCalloutTerminate:
            return IntJobTerminate((PEJOB)Parameters->Job);
 
        default:
            ERR("Unknown job callout %d\n", Parameters->CalloutType);
            return STATUS_INVALID_PARAMETER;
    }
}

Referenced by DriverEntry().

Variable Documentation

gJobInfoList

PJOBINFO gJobInfoList = NULL

static

Definition at line 28 of file job.c.

Referenced by _Requires_exclusive_lock_held_(), and _Requires_lock_held_().