[docs][syscalls] Add TODOs about documenting system call rights

ZX-2399 #comment

Test: no functional change
Change-Id: I1f285c677e2444fcf1d720d7ecbd9f490c303962

[docs][syscalls] Clarify ZX_ERR_NO_MEMORY as eventually going away

Not touched:
vmo_op_range.md
vmo_set_size.md
vmo_write.md
The current text is ok for these.

ZX-2303 #comment patch

Tested: Just doc changes, read before/after.

Change-Id: I2c6e1039e2b205e9cc377b9888755fa7ac676c78

[syscalls] Update parameter types and names

This CL updates the parameter types and names for a number of syscalls
to match the Zircon System API rubric. There's more work to do to make
all the syscalls conform to the rubric, but this change is a start.

Change-Id: I218ac5e7e0cbd80a8c69fef7891ad40b78b6b407

[zircon] Make jobs enter dead state

This removes the temporary state getting "bad state" and aligns
behavior with the other task objects: thread and process

ZX-471 #done

Change-Id: I326b8bd8853f7bdaeaa2626ba6f4745871a9272b

[zx] Magenta -> Zircon

The Great Renaming is here!

Change-Id: I3229bdeb2a3d0e40fb4db6fec8ca7d971fbffb94

[docs] Fix #define reference: MX_WRITE_RIGHT -> MX_RIGHT_WRITE, right?

Change-Id: I37027a7a93c397b218a84ed178ff61c9500e0949

[docs][errors] Rename all the errors in docs/ to MX_OK and MX_ERR_*

Change-Id: I62451456a83145760c6454a619d4c699ce8e9017

[magenta] cleanup deprected thread/process signal

MX_PROCESS_SIGNALED and MX_THREAD_SIGNALED have
been slated to be removed for a while now.

Can't remove them from the header because fuchsia
uses them. Only in like 4 places.

Change-Id: I068e1556d8bdc8cb5b57a6f9b011eb6e924a5836

[kernel][magenta] Enforce job handle != 0

As a transitional step process creation accepted
an invalid handle as a job handle. Remove this.

Change-Id: Ibcd8d670e482199e665fea0002389068ac09c097

[syscalls] Uniformally use "options" rather than "flags" as a syscall parameter name

With the exception of the VMAR syscalls which really do want to talk
about map_flags.

Part of MG-559

Change-Id: I51673de824b4072990f01724a3bf522a9a84f4f4

[docs][syscalls] Fix all the manpages

Change-Id: Ie9ba25060f3331de8d9c178caf6332fb48fc80f5

[kernel][syscalls] Truncate long thread names

Make sys_thread_create and sys_process_create more similar.

Change-Id: If0b4cedf910e96515498435c306e587ba409b794

[syscalls] rename mx_handle_wait_*() to mx_object_wait_*()

These act on the object the handle refers to, not the handle itself.

Compatibility wrappers are provided to ensure existing code
continues to compile, link, and run. Later we will deprecate
the wrappers and eventually remove them.

Change-Id: Icf69e75f7e0c060ba6026343f9d26ff9da4317d9

[kernel][magenta] Add signals to Job objects, reform code

There are now two signals:

- MX_JOB_NO_PROCESSES
- MX_JOB_NO_JOBS

You can wait on them.

So now you can wait until all processes or all jobs are dead.

Along the way we also add a lifetime state to the job object, this
way we can issue mx_task_kill(job) and be sure that if it completes
there are no new processes or jobs that raced their way in.

This results in a new error condition if a process or job is
created when the killing operation is in progress.

In addition, reform the way kill happens by only taking the lock
once, swaping the lists and killing each child.

Change-Id: Id72392ec9282aec51e8401acccb501fa742ca138

[docs] Update syscall docs to the new signal names

Change-Id: Ice62221ddd4493018c519052e17f3a49499f2695

[vm] Implement new VM Address Region syscall interface

For compatibility, allow passing a process handle instead of a VMAR
to the vmar_map/unmap/protect calls and add usermode shims that
translate the old syscalls into the new ones.

Change-Id: I9ba29921d45f47d0d068e46e113dac1d139fce52

[docs] Add some basic job documents

And link the process ones to the job ones.

Change-Id: I89417552478f6076735145e21470e2b25e6b3565

[kernel][magenta] Truncate process name to MX_MAX_NAME_LEN-1 chars.

Change-Id: I3d165948cfadff63a7a4f2f7c50d49e3e7c49714

[docs] Fix links to handle_wait_one.md

Change-Id: Ia8a3509759b264ecdce0cee910663999e8492df3

[kernel][system] Wire job to process

Now process_create takes as firt param the job handle.

We don't yet do much with it except print it in `mx ps

Change-Id: Id1b8dd1e6a3d2f1fa35a5d5e3ef2a70c98428ece

[syscalls] update mx_process_create()

Change-Id: I41701bd7611806c064b5a178d8c341d4477e14e7

[docs][syscalls] thread and process manpages

Change-Id: I539c21a5e6fbf56da1609d4daec00dc7e5d80c63