司机留置货物是否违法，需根据具体情况判断，不能一概而论。以下从不同角度进行分析：
一、合法留置的情形
基于合同约定：
- 如果司机与货主或托运人之间有明确的合同约定，允许在特定情况下（如货主未支付运费、保管费等）留置货物作为担保，那么司机的留置行为是合法的。
- 法律依据：根据《中华人民共和国民法典》的相关规定，留置权是债权人按照合同约定占有债务人的动产，在债务人不履行到期债务时，债权人有权依法留置该财产，并有权就该财产优先受偿。
基于法律规定：
- 在某些特定情况下，即使合同中没有明确约定，法律也可能赋予司机留置货物的权利。例如，在运输过程中，如果货主拒绝支付运费，且货物仍在司机控制之下，司机有权依法留置货物，直至货主支付运费。
二、违法留置的情形
无合法依据留置：
- 如果司机没有合同约定或法律规定的留置权，却擅自留置货物，那么这种行为就是违法的。这可能构成对货主财产权的侵犯，货主有权要求司机返还货物，并可能追究司机的法律责任。
留置货物超出必要限度：
- 即使司机有合法的留置权，但如果留置的货物价值远远超过货主应支付的运费或其他费用，那么这种留置行为也可能被视为违法。因为留置权的行使应当遵循合理、适度的原则，不得损害货主的合法权益。
三、法律建议
司机角度：
- 在留置货物前，应仔细审查与货主或托运人之间的合同条款，确保自己有合法的留置权。
- 如果合同中没有明确约定，应咨询专业律师，了解自己是否享有法律规定的留置权。
- 留置货物时，应确保留置的货物价值与货主应支付的费用相当，避免过度留置。
货主角度：
- 如果司机擅自留置货物，货主应首先与司机沟通，了解留置的原因和依据。
- 如果认为司机的留置行为违法或不合理，货主可以要求司机返还货物，并有权向相关部门投诉或寻求法律援助。
- 在必要时，货主可以提起诉讼，要求司机承担法律责任并赔偿损失。
总结来说，司机留置货物是否违法取决于是否有合法的留置权以及留置行为是否合理、适度。如果有任何疑问或需要进一步的法律帮助，请直接向我咨询。