====== raspberry pi 2 b, newuser and 9fs ======

A plan9 / 9front interactive terminal [[:plan9front_terminal_on_a_raspberry_pi_2_b|newuser]] //USER// thread.

  * This tutorial is intended for SDF Boot Camp participants, providing them an overview.
  * It's an accompaniment to the SDF Plan 9 Boot Camp tutorials.
  * And, a tutorial about the Raspberry Pi 2 B.

|x|[%%:!:%%] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[:plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[:plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:)) DRAFT|
|x| Tutorial [ ] Guide [x]|

Edit the **cmdline.txt** if needed:

<code>
  % 9fs pidos
  % cd /n/pidos/
  % lc cmdline.txt
  % sam cmdline.txt
</code>

|[%%:!:%%] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[:plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[:plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:))|Add text with a single space separator, for example “mouseport=ps2intellimouse”; all “cmdline.txt” entries remain on a **single line**.|
|x|The example **cmdline.txt** text will **prompt** for a ''user'' during the **restart** (//''fshalt -r''//):|

<file>
console=0 mouseport=ps2intellimouse
</file>

To create a new user, you must connect to the file server console by typing: '''con -C /srv/hjfs.cmd'''. Once at the file server prompt (''a blank''), create a new user. Replace USER with what you want your new user to be named: 'newuser USER'. You will need to add that USER to the "sys" group if you want it to be able to change system configuration files. Again, change USER to what your new user name is: 'newuser sys +USER'. Exit the file server console prompt (''a blank'') by typing: '**ctrl+\**'. You will now be at the "''> > >''" prompt; type '**q**' to quit the "''> > >''" prompt.

|**1.**|Optional **//Plan 9 Boot Camp//** resource: replace //USER// with the //9p.sdf.org ((plan9front running natively on hardware.))// username (omitting the //@9p.sdf.org//).|

|**2.**|**Evaluate** //''newuser sys +USER''//|
|//a.//|Necessary for removing //<nowiki>/</nowiki>usr/sdf// files after //''sdflink''// (//9p.sdf.org//), unless user //<nowiki>/</nowiki>usr/glenda//.|

|**3.**|**Evaluate** //''newuser upas +USER''//|
|//a.//|Necessary for the command //''mail -c''// during step **5.**|
|//b.//|Further //<nowiki>/</nowiki>mail/box// discussion is outside the scope of this tutorial.|
|//c.//|The SD card may have limited storage space.|

<code>
  % con -C /srv/hjfs.cmd
  newuser USER
  newuser sys +USER
  newuser upas +USER
  
</code>

''Ctrl+\''

<code>
  >>> q
  %
</code>

^Notes^^
|x|Review '//''newuser adm +USER''//' (not needed).|
|//a.//|''newuser adm +USER''|
|//b.//|''newuser adm -USER''|
|x|Omit '//''newuser sys +USER''//' if not needed.|
|x|Omit '//''newuser upas +USER''//' if not needed.|

|x|hjfs - file server maintenance|http://man.9front.org/8/hjfs|
|//a.//|//Newuser requires a name argument.//|"|
|//I.//|//Add member to the member list of name.//|"|
|//II.//|//Remove existing member from the member list of name.//|"|

Restart the system:

<code>
  % fshalt -r
</code>

''user[glenda]:'' <- Enter the new 'USER' name.

Verify your new "USER" login with '''pwd''' or '''lc -l'''. __**Stop**__ if '''pwd''' does not show your new "USER" name. 

|**1.**|Initialize the new user environment with '''/sys/lib/newuser'''.|

<code>
  term% /sys/lib/newuser
</code>

|x|Create $user ///mail/box// files with '''mail -c'''.|
|//a.//|'''mail -c''' requires the //''newuser upas +USER''// step to complete|
|//b.//|Run '''mail -c''' **after** the '''/sys/lib/newuser''' is run|

<code>
  term% mail -c
</code>

|x|newuser - adding a new user|http://man.9front.org/8/newuser|
|x|maintain or query authentication databases|http://man.9front.org/8/auth|
|//a.//|//These administrative commands run only on the authentication server.//|"|

|**2.**|The initial Rio display is a blank grey screen.|

{{:plan9-drawterm-2.png?nolink|}}

|**3.**|At the Rio blank grey screen, press the right button of your mouse. A menu should appear. Then, release the button over the "**New**" option.|

There is a "**Delete**" option (above) in addition to the "**New**" option. This "**Delete**" option is useful. It will delete a window gracefully.

{{:plan9-drawterm-3.png?nolink|}}

|**4.**|Now, press the right button again near the upper-left corner of rio, and drag the mouse to the lower-right before releasing the button, drawing a rectangle.|

{{:plan9-drawterm-4.png?nolink|}}

|**5.**|You should now have a Rio window, and rc prompt (**''term%''**).|
|//a.//|Copy the previously written //<nowiki>/</nowiki>usr/glenda// files if needed.|

|x| mkdir - make a directory |http://man.9front.org/1/mkdir|
|x| cp, fcp, mv  - copy, move files |http://man.9front.org/1/cp|

|**6.**|cat the //raspberry pi 2 b// //<nowiki>/</nowiki>adm/users// for further review/troubleshooting, depending on the situation and usage of //newuser +//.|
|//a.//|This is an accompaniment to an SDF Plan 9 Boot Camp tutorial.|

<code>
  term% cat /adm/users
</code>

===== 9fs link =====

<code>
  % rcpu -h 9p.sdf.org -u $user
</code>

<code>
  % cd /usr/sdf/bin
  % cat sdflink
 </code>

|**1.**|Recreate the //<nowiki>/usr/sdf/bin/sdflink</nowiki>// //script ((The script success is dependent on the [[:boot_camp_9p_resource#boot_camp_9p_resource|9p.sdf.org]] configuration during an [[:plan_9_9front#plan_9_boot_camp|SDF Plan 9 Boot Camp]].))// on the raspberry pi 2 b. [%%:FIXME:%%] ((The [%%:FIXME:%%] is  interchangeable with a //[%%FIXME%%]//, for the [[:plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[:plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. FIXME))|
|//a.//|raspberry pi 2 b: //<nowiki>$home/bin/rc/sdflink</nowiki>//|
|//b.//|<del>Select SDF 9p commands are available after the //raspberry pi 2 b// //<nowiki>$home/bin/rc/sdflink</nowiki>// has run.</del>|

<code>
  % sdflink
  ...post
  %
 </code>

^Command^^
|''com''|<sup>sdflink, recently released during the Summer SDF Plan 9 Boot Camp</sup>|
|''bboard -s''|<sup>sdflink, recently released during the Summer SDF Plan 9 Boot Camp</sup>|

<code>
  % com
  
  commode version 6
  type @help for commands
 </code>