Perforce .NET API
Perforce.P4
Repository Class
Repository Methods
AddOrUpdateServerLicense Method
CreateBranchSpec Method
CreateChangelist Method
CreateClient Method
CreateDepot Method
CreateGroup Method
CreateJob Method
CreateLabel Method
CreateStream Method
CreateUser Method
DeleteBranchSpec Method
DeleteChangelist Method
DeleteClient Method
DeleteCounter Method
DeleteDepot Method
DeleteGroup Method
DeleteJob Method
DeleteLabel Method
DeleteStream Method
DeleteUser Method
Dispose Method
GetBranchSpec Method
GetBranchSpecs Method
GetChangelist Method
GetChangelists Method
GetClient Method
GetClientMetadata Method
GetClients Method
GetCounter Method
GetCounters Method
GetDepot Method
GetDepotDirs Method
GetDepotFileDiffs Method
GetDepotFiles Method
GetDepots Method
GetFileAnnotations Method
GetFileContents Method
GetFileContentsEx Method
GetFileDiffs Method
GetFileHistory Method
GetFileLineMatches Method
GetFileMetaData Method
GetFiles Method
GetFixes Method
GetFormSpec Method
GetGroup Method
GetGroups Method
GetJob Method
GetJobs Method
GetLabel Method
GetLabels Method
GetMaxProtectionAccess Method
GetOpenedFiles Method
GetProtectionEntries Method
GetProtectionTable Method
GetReviewers Method
GetServerLicenseInformation Method
GetServerMetaData Method
GetStream Method
GetStreamLog Method
GetStreamMetaData Method
GetStreams Method
GetSubmittedIntegrations Method
GetTriggerTable Method
GetTypeMap Method
GetUser Method
GetUsers Method
NewChangelist Method
RenameClient Method
TagFiles Method
UpdateBranchSpec Method
UpdateChangelist Method
UpdateClient Method
UpdateDepot Method
UpdateGroup Method
UpdateJob Method
UpdateLabel Method
UpdateStream Method
UpdateSubmittedChangelist Method
UpdateUser Method
Click or drag to resize

RepositoryGetJobs Method

Get a list of jobs from the repository

Namespace:  Perforce.P4
Assembly:  p4api.net (in p4api.net.dll) Version: 2024.1.265.5426
Syntax
Copy
public IList<Job> GetJobs(
	Options options,
	params FileSpec[] files
)

Parameters

options
Type: Perforce.P4Options
options for the jobs commandJobsCmdFlags
files
Type: Perforce.P4FileSpec
list of files to filter jobs by

Return Value

Type: IListJob
A list containing the matching jobs
Remarks

p4 help jobs

jobs -- Display list of jobs

p4 jobs [-e jobview -i -l -m max -r] [file[revRange] ...]
p4 jobs -R

Lists jobs in the server. If a file specification is included, fixes
for submitted changelists affecting the specified files are listed.
The file specification can include wildcards and a revision range.
See 'p4 help revisions' for details about specifying revisions.

The -e flag lists jobs matching the expression specified in the
jobview parameter. For a description of jobview syntax, see 'p4 help
jobview'.

The -i flag includes any fixes made by changelists integrated into
the specified files.

The -l flag produces long output with the full text of the job
descriptions.

The -m max flag limits the output to the first 'max' jobs, ordered
by their job name.

The -r flag sorts the jobs in reverse order (by job name).

The -R flag rebuilds the jobs table and reindexes each job, which
is necessary after upgrading to 98.2. 'p4 jobs -R' requires that the
user be an operator or have 'super' access granted by 'p4 protect'.

Examples
To get a list of 100 jobs that include files under a given filepath:
Copy
FileSpec path = new FileSpec(new DepotPath(@"//depot/..."), null);
IList<Job> jobs = rep.GetJobs((new Options(JobsCmdFlags.LongDescriptions, null, 100)), path);
To get a list of 100 jobs with the status "open":
Copy
string jobView = "status=open";
IList<Job> jobs = rep.GetJobs((new Options(JobsCmdFlags.LongDescriptions, jobView, 100)), path);
To get a list of 10 jobs in reverse order:
Copy
IList<Job> jobs = rep.GetJobs((new Options(JobsCmdFlags.ReverseSort, null, 10));
To get a list of 10 jobs that include any fixes made by changelists integrated into the specified files:
Copy
FileSpec path = new FileSpec(new DepotPath(@"//depot/..."), null);
IList<Job> jobs = rep.GetJobs((new Options(JobsCmdFlags.IncludeIntegratedFixes, null, 10)), path);
See Also