143051d27SRobert Mustacchi.\" 243051d27SRobert Mustacchi.\" This file and its contents are supplied under the terms of the 343051d27SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0. 443051d27SRobert Mustacchi.\" You may only use this file in accordance with the terms of version 543051d27SRobert Mustacchi.\" 1.0 of the CDDL. 643051d27SRobert Mustacchi.\" 743051d27SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this 843051d27SRobert Mustacchi.\" source. A copy of the CDDL is also available via the Internet at 943051d27SRobert Mustacchi.\" http://www.illumos.org/license/CDDL. 1043051d27SRobert Mustacchi.\" 1143051d27SRobert Mustacchi.\" 1243051d27SRobert Mustacchi.\" Copyright 2015 Joyent, Inc. 1343051d27SRobert Mustacchi.\" 14*a7d7cafeSRobert Mustacchi.Dd November 27, 2023 1543051d27SRobert Mustacchi.Dt PXECBKPT 3PROC 1643051d27SRobert Mustacchi.Os 1743051d27SRobert Mustacchi.Sh NAME 1843051d27SRobert Mustacchi.Nm Pxecbkpt , 1943051d27SRobert Mustacchi.Nm Pxecwapt , 2043051d27SRobert Mustacchi.Nm Lxecbkpt , 2143051d27SRobert Mustacchi.Nm Lxecwapt 2243051d27SRobert Mustacchi.Nd step over a breakpoint or watchpoint 23*a7d7cafeSRobert Mustacchi.Sh LIBRARY 24*a7d7cafeSRobert Mustacchi.Lb libproc 2543051d27SRobert Mustacchi.Sh SYNOPSIS 26*a7d7cafeSRobert Mustacchi.In libproc.h 2743051d27SRobert Mustacchi.Ft int 2843051d27SRobert Mustacchi.Fo Pxecbkpt 2943051d27SRobert Mustacchi.Fa "struct ps_prochandle *P" 3043051d27SRobert Mustacchi.Fa "ulong_t saved" 3143051d27SRobert Mustacchi.Fc 3243051d27SRobert Mustacchi.Ft int 3343051d27SRobert Mustacchi.Fo Pxecwapt 3443051d27SRobert Mustacchi.Fa "struct ps_prochandle *P" 3543051d27SRobert Mustacchi.Fa "ulong_t saved" 3643051d27SRobert Mustacchi.Fc 3743051d27SRobert Mustacchi.Ft int 3843051d27SRobert Mustacchi.Fo Lxecbkpt 3943051d27SRobert Mustacchi.Fa "struct ps_lwphandle *L" 4043051d27SRobert Mustacchi.Fa "ulong_t saved" 4143051d27SRobert Mustacchi.Fc 4243051d27SRobert Mustacchi.Ft int 4343051d27SRobert Mustacchi.Fo Lxecwapt 4443051d27SRobert Mustacchi.Fa "struct ps_lwphandle *L" 4543051d27SRobert Mustacchi.Fa "ulong_t saved" 4643051d27SRobert Mustacchi.Fc 4743051d27SRobert Mustacchi.Sh DESCRIPTION 4843051d27SRobert MustacchiThe 4943051d27SRobert Mustacchi.Fn Pxecbkpt 5043051d27SRobert Mustacchiand 5143051d27SRobert Mustacchi.Fn Pxecwapt 5243051d27SRobert Mustacchifunctions step over a breakpoint or watchpoint respectively in the 5343051d27SRobert Mustacchicorresponding process handle 5443051d27SRobert Mustacchi.Fa P . 5543051d27SRobert MustacchiThe functions execute the original instruction that was at the current 5643051d27SRobert Mustacchiprogram counter, provided by 5743051d27SRobert Mustacchi.Fa saved , 5843051d27SRobert Mustacchiand then leave the process stopped at the next instruction. 5943051d27SRobert Mustacchi.Pp 6043051d27SRobert MustacchiThe process must be stopped at the time that the 6143051d27SRobert Mustacchi.Fn Pxecbkpt 6243051d27SRobert Mustacchior 6343051d27SRobert Mustacchi.Fn Pxecwapt 6443051d27SRobert Mustacchifunctions are called. 6543051d27SRobert Mustacchi.Pp 6643051d27SRobert MustacchiThe 6743051d27SRobert Mustacchi.Fn Lxecbkpt 6843051d27SRobert Mustacchiand 6943051d27SRobert Mustacchi.Fn Lxecwapt 7043051d27SRobert Mustacchifunctions are identical to 7143051d27SRobert Mustacchi.Fn Pxecbkpt 7243051d27SRobert Mustacchiand 7343051d27SRobert Mustacchi.Fn Pxecwapt , 7443051d27SRobert Mustacchirespectively; except rather than operating on the process as a 7543051d27SRobert Mustacchiwhole, they operate on the thread handle 7643051d27SRobert Mustacchi.Fa L . 7743051d27SRobert MustacchiThese functions only require that the thread represented by 7843051d27SRobert Mustacchi.Fa L 7943051d27SRobert Mustacchibe stopped and not the entire process. 8043051d27SRobert Mustacchi.Sh RETURN VALUES 8143051d27SRobert MustacchiUpon successful completion, the 8243051d27SRobert Mustacchi.Fn Pxecbkpt , 8343051d27SRobert Mustacchi.Fn Pxecwapt , 8443051d27SRobert Mustacchi.Fn Lxecbkpt , 8543051d27SRobert Mustacchiand 8643051d27SRobert Mustacchi.Fn Lxecwapt 8743051d27SRobert Mustacchifunctions return 8843051d27SRobert Mustacchi.Sy 0 8943051d27SRobert Mustacchihaving executed the original instruction at 9043051d27SRobert Mustacchi.Fa saved . 9143051d27SRobert MustacchiOtherwise, 9243051d27SRobert Mustacchi.Sy -1 9343051d27SRobert Mustacchiis returned and 9443051d27SRobert Mustacchi.Sy errno 9543051d27SRobert Mustacchiis set to indicate the error. 9643051d27SRobert Mustacchi.Sh ERRORS 9743051d27SRobert MustacchiFor a full list of errors see the 9843051d27SRobert Mustacchi.Sy DIAGNOSTICS 9943051d27SRobert Mustacchisection in 100bbf21555SRichard Lowe.Xr proc 5 . 10143051d27SRobert MustacchiThe 10243051d27SRobert Mustacchi.Fn Pxecbkpt , 10343051d27SRobert Mustacchi.Fn Pxecwapt , 10443051d27SRobert Mustacchi.Fn Lxecbkpt , 10543051d27SRobert Mustacchiand 10643051d27SRobert Mustacchi.Fn Lxecwapt 10743051d27SRobert Mustacchifunctions will fail if: 10843051d27SRobert Mustacchi.Bl -tag -width Er 10943051d27SRobert Mustacchi.It Er EBUSY 11043051d27SRobert MustacchiEither 11143051d27SRobert Mustacchi.Fa P 11243051d27SRobert Mustacchior 11343051d27SRobert Mustacchi.Fa L 11443051d27SRobert Mustacchiis not stopped. 11543051d27SRobert Mustacchi.El 11643051d27SRobert Mustacchi.Sh INTERFACE STABILITY 11743051d27SRobert Mustacchi.Sy Uncommitted 11843051d27SRobert Mustacchi.Sh MT-LEVEL 11943051d27SRobert MustacchiSee 12043051d27SRobert Mustacchi.Sy LOCKING 12143051d27SRobert Mustacchiin 12243051d27SRobert Mustacchi.Xr libproc 3LIB . 12343051d27SRobert Mustacchi.Sh SEE ALSO 12443051d27SRobert Mustacchi.Xr libproc 3LIB , 12543051d27SRobert Mustacchi.Xr Pdelbkpt 3PROC , 12643051d27SRobert Mustacchi.Xr Pdelwapt 3PROC , 12743051d27SRobert Mustacchi.Xr Psetbkpt 3PROC , 12843051d27SRobert Mustacchi.Xr Psetwapt 3PROC , 129bbf21555SRichard Lowe.Xr proc 5 130