Differential D9174

Direct reader to install packages first in desktop chapter of handbook
ClosedPublic
Actions

Authored by sevan on Jan 14 2017, 6:00 AM.

Details

Reviewers

bcr

Commits

rD49854: Direct reader to install packages first.

Summary

In examples where installation of software is needed, place the instructions to install binary packages first.

Diff Detail

Repository

rD FreeBSD doc repository - subversion

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

sevan updated this revision to Diff 23986.Jan 14 2017, 6:00 AM

sevan retitled this revision from to Direct reader to install packages first in desktop chapter of handbook.

sevan updated this object.

sevan edited the test plan for this revision. (Show Details)

sevan added a reviewer: bcr.

sevan set the repository for this revision to rD FreeBSD doc repository - subversion.

sevan added a project: Doc Committers.

Also fine and approved!

This revision is now accepted and ready to land.Jan 14 2017, 11:57 AM

Closed by commit rD49854: Direct reader to install packages first. (authored by sevan). · Explain WhyJan 15 2017, 2:54 AM

This revision was automatically updated to reflect the committed changes.

Revision Contents
Changeset List

Path

Size

en_US.ISO8859-1/

books/

handbook/

desktop/

chapter.xml

13 lines

Diff 23986

View Options

en_US.ISO8859-1/books/handbook/desktop/chapter.xml

Show First 20 Lines • Show All 101 Lines • ▼ Show 20 Lines
#define LINUX_PTRACE_SYSCALL_INFO_ENTRY 1		#define LINUX_PTRACE_SYSCALL_INFO_ENTRY 1
#define LINUX_PTRACE_SYSCALL_INFO_EXIT 2		#define LINUX_PTRACE_SYSCALL_INFO_EXIT 2

#define LINUX_PTRACE_PEEKUSER_ORIG_RAX 120		#define LINUX_PTRACE_PEEKUSER_ORIG_RAX 120
#define LINUX_PTRACE_PEEKUSER_RIP 128		#define LINUX_PTRACE_PEEKUSER_RIP 128
#define LINUX_PTRACE_PEEKUSER_CS 136		#define LINUX_PTRACE_PEEKUSER_CS 136
#define LINUX_PTRACE_PEEKUSER_DS 184		#define LINUX_PTRACE_PEEKUSER_DS 184

#define LINUX_ARCH_AMD64 0xc000003e
#define LINUX_ARCH_AARCH64 0xc00000b7

static int		static int
map_signum(int lsig, int *bsigp)		map_signum(int lsig, int *bsigp)
{		{
int bsig;		int bsig;

if (lsig == 0) {		if (lsig == 0) {
*bsigp = 0;		*bsigp = 0;
return (0);		return (0);
▲ Show 20 Lines • Show All 43 Lines • ▼ Show 20 Lines	linux_ptrace_status(struct thread *td, pid_t pid, int status)
if ((pem->ptrace_flags & LINUX_PTRACE_O_TRACEEXIT) &&		if ((pem->ptrace_flags & LINUX_PTRACE_O_TRACEEXIT) &&
lwpinfo.pl_flags & PL_FLAG_EXITED)		lwpinfo.pl_flags & PL_FLAG_EXITED)
status \|= (LINUX_SIGTRAP \| LINUX_PTRACE_EVENT_EXIT << 8) << 8;		status \|= (LINUX_SIGTRAP \| LINUX_PTRACE_EVENT_EXIT << 8) << 8;
LINUX_PEM_SUNLOCK(pem);		LINUX_PEM_SUNLOCK(pem);

return (status);		return (status);
}		}

struct syscall_info {
uint8_t op;
uint32_t arch;
uint64_t instruction_pointer;
uint64_t stack_pointer;
union {
struct {
uint64_t nr;
uint64_t args[6];
} entry;
struct {
int64_t rval;
uint8_t is_error;
} exit;
struct {
uint64_t nr;
uint64_t args[6];
uint32_t ret_data;
} seccomp;
};
};

static int		static int
linux_ptrace_peek(struct thread td, pid_t pid, void addr, void *data)		linux_ptrace_peek(struct thread td, pid_t pid, void addr, void *data)
{		{
int error;		int error;

error = kern_ptrace(td, PT_READ_I, pid, addr, 0);		error = kern_ptrace(td, PT_READ_I, pid, addr, 0);
if (error == 0)		if (error == 0)
error = copyout(td->td_retval, data, sizeof(l_int));		error = copyout(td->td_retval, data, sizeof(l_int));
▲ Show 20 Lines • Show All 138 Lines • ▼ Show 20 Lines	linux_ptrace_getsiginfo(struct thread *td, pid_t pid, l_ulong data)
return (error);		return (error);
}		}

static int		static int
linux_ptrace_getregs(struct thread td, pid_t pid, void data)		linux_ptrace_getregs(struct thread td, pid_t pid, void data)
{		{
struct reg b_reg;		struct reg b_reg;
struct linux_pt_regset l_regset;		struct linux_pt_regset l_regset;
#ifdef __amd64__
struct ptrace_lwpinfo lwpinfo;
struct pcb *pcb;
#endif
int error;		int error;

error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);		error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);
if (error != 0)		if (error != 0)
return (error);		return (error);

bsd_to_linux_regset(&b_reg, &l_regset);		bsd_to_linux_regset(&b_reg, &l_regset);
		error = linux_ptrace_getregs_machdep(td, pid, &l_regset);
#ifdef __amd64__		if (error != 0)
pcb = td->td_pcb;
if (td == curthread)
update_pcb_bases(pcb);

l_regset.fs_base = pcb->pcb_fsbase;
l_regset.gs_base = pcb->pcb_gsbase;

error = kern_ptrace(td, PT_LWPINFO, pid, &lwpinfo, sizeof(lwpinfo));
if (error != 0) {
linux_msg(td, "PT_LWPINFO failed with error %d", error);
return (error);		return (error);
}
if (lwpinfo.pl_flags & PL_FLAG_SCE) {
/*
* Undo the mangling done in exception.S:fast_syscall_common().
*/
l_regset.r10 = l_regset.rcx;
}
if (lwpinfo.pl_flags & (PL_FLAG_SCE \| PL_FLAG_SCX)) {
/*
* In Linux, the syscall number - passed to the syscall
* as rax - is preserved in orig_rax; rax gets overwritten
* with syscall return value.
*/
l_regset.orig_rax = lwpinfo.pl_syscall_code;
}
#endif

error = copyout(&l_regset, (void *)data, sizeof(l_regset));		error = copyout(&l_regset, (void *)data, sizeof(l_regset));
return (error);		return (error);
}		}

static int		static int
linux_ptrace_setregs(struct thread td, pid_t pid, void data)		linux_ptrace_setregs(struct thread td, pid_t pid, void data)
{		{
Show All 10 Lines
}		}

static int		static int
linux_ptrace_getregset_prstatus(struct thread *td, pid_t pid, l_ulong data)		linux_ptrace_getregset_prstatus(struct thread *td, pid_t pid, l_ulong data)
{		{
struct reg b_reg;		struct reg b_reg;
struct linux_pt_regset l_regset;		struct linux_pt_regset l_regset;
struct iovec iov;		struct iovec iov;
#ifdef __amd64__
struct ptrace_lwpinfo lwpinfo;
struct pcb *pcb;
#endif
size_t len;		size_t len;
int error;		int error;

error = copyin((const void *)data, &iov, sizeof(iov));		error = copyin((const void *)data, &iov, sizeof(iov));
if (error != 0) {		if (error != 0) {
linux_msg(td, "copyin error %d", error);		linux_msg(td, "copyin error %d", error);
return (error);		return (error);
}		}

error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);		error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);
if (error != 0)		if (error != 0)
return (error);		return (error);

bsd_to_linux_regset(&b_reg, &l_regset);		bsd_to_linux_regset(&b_reg, &l_regset);
		error = linux_ptrace_getregs_machdep(td, pid, &l_regset);
#ifdef __amd64__		if (error != 0)
pcb = td->td_pcb;
if (td == curthread)
update_pcb_bases(pcb);

l_regset.fs_base = pcb->pcb_fsbase;
l_regset.gs_base = pcb->pcb_gsbase;

error = kern_ptrace(td, PT_LWPINFO, pid, &lwpinfo, sizeof(lwpinfo));
if (error != 0) {
linux_msg(td, "PT_LWPINFO failed with error %d", error);
return (error);		return (error);
}
if (lwpinfo.pl_flags & PL_FLAG_SCE) {
/*
* Undo the mangling done in exception.S:fast_syscall_common().
*/
l_regset.r10 = l_regset.rcx;
}

if (lwpinfo.pl_flags & (PL_FLAG_SCE \| PL_FLAG_SCX)) {
/*
* In Linux, the syscall number - passed to the syscall
* as rax - is preserved in orig_rax; rax gets overwritten
* with syscall return value.
*/
l_regset.orig_rax = lwpinfo.pl_syscall_code;
}
#endif

len = MIN(iov.iov_len, sizeof(l_regset));		len = MIN(iov.iov_len, sizeof(l_regset));
error = copyout(&l_regset, (void *)iov.iov_base, len);		error = copyout(&l_regset, (void *)iov.iov_base, len);
if (error != 0) {		if (error != 0) {
linux_msg(td, "copyout error %d", error);		linux_msg(td, "copyout error %d", error);
return (error);		return (error);
}		}

iov.iov_len = len;		iov.iov_len = len;
▲ Show 20 Lines • Show All 106 Lines • ▼ Show 20 Lines	linux_ptrace_get_syscall_info(struct thread *td, pid_t pid,
} else {		} else {
si.op = LINUX_PTRACE_SYSCALL_INFO_NONE;		si.op = LINUX_PTRACE_SYSCALL_INFO_NONE;
}		}

error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);		error = kern_ptrace(td, PT_GETREGS, pid, &b_reg, 0);
if (error != 0)		if (error != 0)
return (error);		return (error);

#if defined(__amd64__)		linux_ptrace_get_syscall_info_machdep(&b_reg, &si);
si.arch = LINUX_ARCH_AMD64;
si.instruction_pointer = b_reg.r_rip;
si.stack_pointer = b_reg.r_rsp;
#elif defined(__aarch64__)
si.arch = LINUX_ARCH_AARCH64;
si.instruction_pointer = b_reg.lr;
si.stack_pointer = b_reg.sp;
#else
#error "unknown architecture"
#endif

len = MIN(len, sizeof(si));		len = MIN(len, sizeof(si));
error = copyout(&si, (void *)data, len);		error = copyout(&si, (void *)data, len);
if (error == 0)		if (error == 0)
td->td_retval[0] = sizeof(si);		td->td_retval[0] = sizeof(si);

return (error);		return (error);
}		}
▲ Show 20 Lines • Show All 110 Lines • Show Last 20 Lines

Direct reader to install packages first in desktop chapter of handbookClosedPublicActions